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Preface 



This manual is the Programmer’s Reference Manual for as — the assembler for 
Sun-2 and Sun-3 workstations running the SunOS operating system, as converts 
source programs written in assembly language into a form that the linker utility, 
ld{ 1) will turn into a runnable program. 

as provides assembly language programmers with a minimal set of facilities to 
write programs in assembly language. Since most programming is done in high- 
level languages, as doesn’t provide any elaborate macro facilities or conditional 
assembly features. It is assumed that the volume of assembly code produced is 
so small that these facilities aren’t required. If they are needed, you can use the 
C preprocessor (see cpp( 1)) to provide them. 

This manual describes the syntax and usage of the as assembler for the Motorola 
MC68010 and MC68020 microprocessors, the MC6888 1 floating-point coproces- 
sor, and Sun’s Floating-Point Accelerator (FPA). The basic format of as is 
loosely based on the Digital Equipment Corporation’s Macro- 1 1 assembler 
described in DEC’S publication DEC-1 1-OMACA-A-D. It also contains elements 
of the UNIX! PDP-11 as assembler. The instruction mnemonics and effective 
address format are based on a Motorola publication on the MC68000: the 
MACSS MC68000 Design Specification Instruction Set Processor dated June 30, 
1979. 

This is a reference manual as opposed to a treatise on writing in assembly 
language. It assumes that you are familiar with the concepts of machine architec- 
ture, the reasons for an assembler, the ideas of instruction mnemonics, operands, 
and effective address modes, and assembler directives. It also assumes that you 
are familiar with the relevant processors, their instruction sets and addressing 
modes, and especially their irregularities. 

Motorola MC68010 16-bit Microprocessor Programmer’s Reference Manual. 
Motorola MC68020 32-bit Microprocessor User’s Manual. 

Motorola MC6888 1 Floating-Point Coprocessor User’s Manual. 



t UNIX is a registered trademark of AT&T. 
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Introduction 



1.1. Using the Assembler By convention, the assembly language source code of the program should be in 

one or more files with a . s suffix. Suppose that your program is in two files 
called part s . s and rest.s. To run the assembler, type the command: 



r 

tutorial% as parts. s rest.s 


-\ 




J 



as runs silently (if there are no errors), and generates a file called a . out. 
as also accepts several command-line options. These are: 



-o file Place the output of the assembler in file instead of a. out. 

-m68010 This is the default on Sun-2 systems. Accept only the MC680 10 
instruction set and addressing modes. This also puts the MC68010 
machine type tag into the a.out file. 

-m68020 This is the default on Sun-3 systems. Accept the full MC68020, 
MC6888 1, and Sun FPA instruction sets and addressing modes. 
Includes the MC68010 instruction set and addressing modes as a 
subset, and also puts the MC68020 machine type tag into the a.out 
file. 



-k Generate position-independent code as required by 



f 




>v 




cc -pic/-PIC 








J 



WARNING Don't apply this flag to hand-coded assembler programs unless they are written 

to be position-independent 

-O Perform span-dependent instruction resolution over each entire file, 

rather than just over each procedure (see the description of the .proc 
pseudo-operation in Chapter 5). 

-R Make initialized data segments read-only (actually the assembler 

places them at the end of the .text area). 

-L Keep local (compiler-generated) symbols that start with the letter L. 

This is a debugging feature. If the -L option is omitted, the assem- 
bler discards those symbols and does not include them in the symbol 
table. 
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1.2. Notation 



-j 


Make all jumps to external symbols ( j sr and jmp) 

PC-relative rather than long- absolute. This is intended for use when 
the programmer knows that the program is short, since it only per- 
mits jumps (forward or back) up to 32K bytes long. If there are any 
externals which are too far away, the loader will complain when the 
program is linked. 


-J 


Suppress span-dependent instruction calculations and force all 
branches and calls to take the most general form. This is used when 
assembly time must be minimized, but program size and run time 
are not important. 


-h 


Suppress span-dependent instruction calculations and force all 
branches to be of medium length, but all calls to take the most gen- 
eral form. This is used when assembly time must be minimized, but 
program size and running time are not important. This option results 
in a smaller and faster program than that produced by the - J option, 
but some very large programs may not be able to use it because of 
the limits of the medium-length branches. 


— d2 


This is intended for small stand-alone programs. The assembler 
makes all program references PC-relative and all data references 
short-absolute. Note that the - j option does half this job. 


You should also consult the SunOS Reference Manual entry on as. 


The notation used in this manual is a somewhat modified Backus-Naur Form 
(BNF). A string of characters on its own stands for itself, for example: 


r 

WIDGET 
< 


■\ 

j 


is an occurrence of the literal string ‘WIDGET’, and: 


( 

1983 

< 


j 


is an occurrence of the literal constant 1983. An element enclosed in < and > 
signs is a non-terminal symbol, and must eventually be defined in terms of some 
other entities. For example. 


r 

<identifier> 
v 


j 


stands for the syntactic construct called ‘identifier’, which is eventually defined 
in terms of basic objects. A syntactic object followed by an ellipsis: 


<thing> . 

V 


/ 



denotes one or more occurrences of <thing>. 
Syntactic objects occurring one after the other, as in: 
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<first thing > 



<second thing > 



simply means an occurrence of first thing followed by second thing. Syntactic 
elements separated by a vertical bar sign ( I ), as in: 

<letter> \ <digit> 

V 

mean an occurrence of <letter> or <digit> but not both. Brackets and braces 
define the order of interpretation. Brackets also indicate that the syntax 
described by the subexpression they enclose is optional. That is: 

[ <thing> ] 

v 

denotes zero or one occurrences of <thing>, while { and } are used for grouping 
so that 

{ <thing one> | <thing two> } <thing three> 
denotes a <thing one> or a <thing two>, followed by a <thing three>. 
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Elements of Assembly Language 



This chapter covers the lexical elements which comprise an assembly language 
program. (Chapter 3 discusses the rules for expression and operand formation.) 
Topics covered in this chapter are: 

□ The character set that the assembler recognizes, 

□ Rules for identifiers and labels , 

□ Syntax for numeric constants , 

□ Syntax for string constants , 

□ The assembly location counter. 

An assembly language program is ultimately constructed from characters. Char- 
acters are combined to make up lexical elements or tokens of the language. Com- 
binations of tokens form assembly language statements, and sequences of state- 
ments form an assembly language program. This section describes the basic lexi- 
cal elements of as. 

2.1. Character Set as recognizes the following character set: 

□ The letters A through Z and a through z. 

□ The digits 0 through 9. 

□ The ASCII graphic characters — the printing characters other than letters 
and digits. 

□ The ASCII non-graphics : space, tab, carriage return, and newline (also 
known as linefeed). 

2.2. Identifiers Identifiers are used to tag assembler statements (where they are called labels ), as 

location tags for data, and as the symbolic names of constants. 

An identifier in an as program is a sequence of from 1 to 255 characters from the 
set: 

□ Upper case letters A through Z. 

□ Lower case letters a through z . 

□ Digits 0 through 9. 
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□ The characters underline (_), period ( . ), and dollar sign ( $). 

The first character of an identifier must not be numeric. Other than that restric- 
tion, there are a few other points to note: 

□ All characters of an identifier are significant and are checked in comparisons 
with other identifiers. 

□ Upper case letters and lower case letters are distinct, so that 
kit_of_parts and KIT_OF_parts are two different identifiers. 

□ Although the period ( .) and dollar sign ( $) characters can be used to con- 
struct identifiers, they are reserved for special purposes (pseudo-ops for 
instance) and should not appear in user-defined identifiers. 



Here are some examples of legal identifiers: 



/ 


Grab_Hold 

Widget 


\ 




Pot of Message 






MAXNAME 




V 




J 



A numeric label consists of a digit (0 to 9) followed by a colon. As in the case of 
alphanumeric labels, a numeric label assigns the current value of the location 
counter to the symbol. However, several numeric labels with the same digit may 
be used within the same assembly. References of the form nb refer to the first 
numeric label named n backwards from the reference; n f symbols refer to the 
first numeric label named nfo rwards from the reference. 

Local labels are a special form of identifier which are strictly local to a control 
section (see Section 5.4). Local labels provide a convenient means of generating 
labels for branch instructions and such. Use of local labels reduces the possibil- 
ity of multiply defined labels in a program, and separates entry point labels from 
local references, such as the top of a loop. Local labels cannot be referenced 
from outside the current assembly unit. Local labels are of the form n$ where n 
is any integer. Valid local labels include: 



r 


1$ 






27$ 






394$ 




V 




J 



2.5. Scope of Labels The scope of a label is the ‘distance’ over which it is visible to other parts of the 

program which may reference it. An ordinary label which tags a location in the 
program or data is visible only within the current assembly. An identifier which 
is designated as an external identifier via a . globl directive is visible to other 
assembly units at link time. 

Local labels have a scope, or span of reference, which extends between one ordi- 
nary label and the next. Every time an ordinary label is encountered, all previous 

sun Revision A of May 9, 1988 
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2.4. Local Labels 
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local labels associated with the current location counter are discarded, and a new 
local label scope is created. The following example illustrates the scopes of the 
different kinds of labels: 



first : 


addl 


dO, dl 


I creates a 


new local label scope 


\ 


100$: 


addqw 

bees 


#7 , d3 
100$ 


| first appearance of 100$ 

I branches to the label above 




second: 


andl 


#0x7ff,d4 


I above 100$ has gone away 




100$: 


empw 

beqs 


dl,d3 

100$ 


I this is a 
| branches 


different 100$ 
to the previous instruction 




third : 

v 


movw 

beqs 


dO , d7 
100$ 


| now 100$ 

I generates 


has gone away again 
an error message if no 100$ below 


> 



The labels first, second, and third all have a scope which is the entire 
source file containing them. The first appearance of the local label 1 0 0 $ has a 
scope which extends between first and second. 

The second appearance of the local label 1 0 0 $ has a scope which extends 
between second and third. After the appearance of the label third, the 
branch to 1 0 0 $ will generate an error message because that label is no longer 
defined in this scope. 

2.6. Constants There are two forms of constants available to as users, namely numeric con- 

stants and string constants. All constants are considered absolute quantities 
when they appear in an expression (see Section 3.4 for a discussion on absolute 
and relocatable expressions). 

2.7. Numeric Constants as assumes that any token which starts with a digit is a numeric constant, as 

accepts numeric quantities in decimal (base 10), hexadecimal (base 16), or octal 
(base 8) radices. Numeric constants can represent quantities up to 32 bits in 
length. 

Decimal numbers consist of between one and ten decimal digits (in the range 0 
through 9). The range of decimal numbers is between -2,147,483,648 and 
2,147,483,647. Note that you can’t have commas in decimal numbers even 
though they are shown here for readability. Note also that decimal numbers can’t 
be written with leading zeros, because a numeric constant starting with a zero is 
taken as either an octal constant or a hexadecimal constant, as described below. 

Hexadecimal constants start with the notation Ox or OX (zero-ex) and can then 
have between one and eight hexadecimal digits. The hexadecimal digits consist 
of the decimal digits 0 through 9 and the hexadecimal digits a through f or 
A through F. 

Octal constants start with the digit 0. There can then be from one to 1 1 octal 
digits (0 through 7) in the number. But note that 1 1 octal digits is 33 bits, so the 
largest octal number is 037777777777. 
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Floating-point constants must start with #0r or #0R, which may be followed by 
an optional sign and either a number, an infinity or a nan ("not a number"). The 
syntax is 



/ 






\ 




{ #0r | #0R} [+ | 


-] {<number> | inf | nan} 




V 






J 



where the syntax of a <number> is 



r 




\ 


{ <digits> [. [<digits>] ] | 


i . <digits> } [E [+ | -] <digits> ] 








J 



and <digits> is a string of decimal digits. 

2.8. String Constants A string is a sequence of ASCII characters, enclosed in quote signs ". 

Within string constants, the quote sign is represented by a backslash character 
followed by a quote sign. The backslash character itself is represented by two 
backslash characters. Any other character can be represented by a backslash 
character followed by one, two, or three octal digits, or by a backslash followed 
by Ox or OX and a one- or two-digit hexadecimal constant. The table below 
shows the octal representation of some of the more common non-printing charac- 
ters. 



Character 


Octal 


Hex 


Backspace 


\010 


0x8 


Horizontal Tab 


\011 


0x9 


Newline (Linefeed) 


\012 


OxA 


Formfeed 


\0 14 


OxC 


Carriage Return 


\015 


OxD 



2.9. Assembly Location The assembly location counter is the period character ( . ). It is colloquially 

Counter known as dot. When used in the operand field of any statement, dot represents 

the address of the first byte of the statement. Even in assembler directives, dot 
represents the address of the start of that assembler directive. For example, if dot 
appears as the third argument in a . long directive, the value placed at that loca- 
tion is the address of the first location of the directive — dot is not updated until 
the next machine instruction or assembler directive. For example: 



/ 






A 


Ralph: 


movl . , aO | 


load value of Ralph into aO 


j 
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You can reserve storage by advancing dot. 
For example, the statement 



— 




"v 


Table : 


.=.+0x100 




v 




J 



reserves 256 bytes (100 hexadecimal) of storage, with the address of the first byte 
as the value of Table. This is exactly equivalent to using . skip ( the preferred 
syntax) as follows: 



r 






a 


Table : 


. skip 


0x100 




V 






J 



The value of dot is always relative to the start of the current control section. For 
example, 

' > 

. = 0x1000 

s > 



doesn’t set dot to absolute location 0x1000, but to location 0x1000 relative to the 
start of the current control section. This practice is not recommended. 
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Expressions 



Expressions are combinations of operands (numeric constants and identifiers) and 
operators, forming new values. The sections below define the operators which 
as provides, then gives the rules for combining terms into expressions. 

3.1. Operators Identifiers and numeric constants can be combined, via arithmetic operators, to 

form expressions, as provides unary operators and binary operators, as 
described below. 

Table 3-1 Unary Operators in Expressions 



Operator 


Function 


Description 


- 


unary minus 


Two’s complement of its argument. 


~~ 


logical negation 


One’s complement (logical negation) of its argu- 
ment. 



Table 3-2 Binary Operators in Expressions 



Operator 


Function 


Description 


+ 


addition 


Arithmetic addition of its arguments. 


- 


subtraction 


Arithmetic subtraction of its arguments. 


* 


multiplication 


Arithmetic multiplication of its arguments. 


/ 


division 


Arithmetic division of its arguments. Note that 
division in as is integer division, which trun- 
cates towards zero. 



Each operator works on 32-bit numbers. If the value of a particular term occu- 
pies only 8 bits or 16 bits, it is sign extended to a full 32-bit value. 




17 
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3.2. Terms A term is a component of an expression. A term may be any of the following: 

□ A numeric constant, whose 32-bit value is used. The assembly location 
counter, known as dot, is considered a number in this context. 

□ An identifier. 

□ An expression or term enclosed in parentheses ( ) . 

Any quantity enclosed in parentheses is evaluated before the rest of the 
expression. This can be used to alter the normal left-to-right evaluation of 
expressions — for example, differentiating between a*b+c and a* (b+c ) 
or to apply a unary operator to an entire expression — for example, 

— (a*b+c) . 

□ A term preceded by a unary operator. For example, both 
double_plus_ungood and ~double_plus_ungood are terms. 

Multiple unary operators can be used in a term. For example, pos it ive 

has the same value as positive. 

3.3. Expressions Expression are combinations of terms joined together by binary operators. An 

expression is always evaluated to a 32-bit value. 

If the operand requires only a single-byte value (a . byte directive or an addq 
instruction, for example) the low-order eight bits of the expression are used. 

If the operand requires only a 16-bit value (a . word directive or a movem 
instruction, for example) the low-order 16 bits of the expression are used. 

Expressions are evaluated left to right with no operator precedence. Thus 

^ 

1 + 2*3 

< i 



evaluates to 9, not 7. Unary operators have precedence over binary operators 
since they are considered part of a term, and both terms of a binary operator must 
be evaluated before the binary operator can be applied. 

A missing expression or term is interpreted as having a value of zero. In this 
case, an Invalid expression error is generated. 

An Invalid Operator error means that a valid end-of-line character or binary 
operator was not detected after the assembler processed a term. In particular, this 
error is generated if an expression contains an identifier with an illegal character, 
or if an incorrect comment character was used. 

3.4. Absolute, Relocatable, When an expression is evaluated, its value is either absolute, relocatable, or 

external: 

An expression is absolute if its value is fixed. 

□ An expression whose terms are constants is absolute. 

□ An identifier whose value is a constant via a direct assignment statement is 
absolute. 



and External 
Expressions 
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□ A relocatable expression minus a relocatable term is absolute, if both items 
belong to the same program section. 

An expression is relocatable if its value is fixed relative to a base address, but 
will have an offset value when it is linked or loaded into memory. All labels of a 
program defined in relocatable sections are relocatable terms. 

Expressions which contain relocatable terms must only add or subtract constants 
to their value. For example, assuming the identifiers widget and blivet 
were defined in a relocatable section of the program, then the following demon- 
strates the use of relocatable expressions: 



Expression 


Description 


widget 


is a simple relocatable term. Its value is an offset from 
the base address of the current control section. 


widget+5 


is a simple relocatable expression. Since the value of 
widget is an offset from the base address of the current 
control section, adding a constant to it does not change 
its relocatable status. 


widget*2 


Not relocatable. Multiplying a relocatable term by a 
constant invalidates the relocatable status. 


2-widget 


Not relocatable, since the expression cannot be linked by 
adding widget ’s offset to it. 


widget— blivet 


Absolute, since the offsets added to widget and 
blivet cancel each other out. 



An expression is external (or global) if it contains an external identifier not 
defined in the current program. With one exception, the same restrictions on 
expressions containing relocatable identifiers apply to expressions containing 
external identifiers. The exception is that the expression 



/ 


'N 


widget-blivet 




v 


J 



is incorrect when both widget and blivet are external identifiers — you 
cannot subtract two external relocatable expressions. In addition, you cannot 
multiply or divide any relocatable expression. 
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Assembly Language Program Layout 



An as program consists of a series of statements. Several statements can be 
written on one line, but statements cannot cross line boundaries. The format of a 
statement is: 




It is possible to have a statement which consists of only a label field. 

The fields of a statement can be separated by spaces or tabs. There must be at 
least one space or tab separating the opcode field from the operand field, but 
spaces are unnecessary elsewhere. Spaces may appear in the operand field. 
Spaces and tabs are significant when they appear in a character string (for 
instance, as the operand of an .ascii pseudo-op) or in a character constant. In 
these cases, a space or tab stands for itself. 

A line is a sequence of zero or more statements, optionally followed by a com- 
ment, ending with a < newline> character. A line can be up to 4096 characters 
long. Multiple statements on a line are separated by semicolons. Blank lines are 
allowed. The form of a line is: 




4.1. Label Field Labels are identifiers which the programmer may use to tag the locations of pro- 

gram and data objects. The format of a <label field> is: 




If present, a label always occurs first in a statement and must be terminated by a 
colon: 
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More than one label may appear in the same source statement, each one being 
terminated by a colon: 



— 




\ 


presson: grab: hold: 


| multiple labels defined here. 




V 




) 



The collection of label definitions in a statement is called the label field. 

When a label is encountered in the program, the assembler assigns that label the 
value of the current location counter. The value of a label is relocatable. The 
symbol’s absolute value is assigned when the program is linked with the system 
linker ld{ 1). 

4.2. Operation Code Field The operation code field of an assembly language statement identifies the state- 
ment as either a machine instruction or an assembler directive. 

One or more spaces (or tabs) must separate the operation code field from the fol- 
lowing operand field in a statement. Spaces or tabs are unnecessary between the 
label and operation code fields, but they are recommended to improve readability 
of the program. 

A machine instruction is indicated by an instruction mnemonic. The assembly 
language statement is intended to produce a single executable machine instruc- 
tion. The operation of each instmction is described in the manufacturer’s user 
manual. Conventions used in as for instmction mnemonics are described in 
Chapter 6 and a complete list of the instructions is presented in Appendix B. 

An assembler directive, or pseudo-op, performs some function during the assem- 
bly process. It does not produce any executable code, but it may assign space for 
data in a program. 

Note that as expects that all instmction mnemonics in the op-code field should 
be in lower case only. Using upper case letters in instmction mnemonics gives 
rise to an error message. 

The names of register operands must also be in lower case only. This behavior 
differs from the case of identifiers, where both upper and lower case letters may 
be used and are considered distinct. 

Many MC68010 and MC68020 machine instructions can operate upon byte (8- 
bit), word (16-bit), or long word (32-bit) data. The size which the programmer 
requires is indicated as part of the instmction mnemonic. For instance, a movb 
instmction moves a byte of data, a movw instmction moves a 16-bit word of data, 
and a movl instmction moves a 32-bit long word of data. In general, the default 
size for data manipulation instructions is word. 

Many MC6888 1 machine instructions can operate on byte, word or long word 
integer data, on single-precision (32-bit), double-precision (64-bit) or extended- 
precision (96-bit) floating-point data or on packed-decimal (96-bit) data. The 
size required is specified as part of the instmction mnemonic by a trailing "b", 
V, "1", "s", "d", "x" or p, respectively. 

An alternate coprocessor id can be specified for MC6888 1 instructions by 
appending @id to the opcode, such as f add@2. If you don’t do this, the 
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coprocessor id specified by the most recent . cpid pseudo-operation is used. 
(See Chapter 5.) 

Similarly, branch instructions can use a long or short offset specifier to indicate 
the destination. So the beq instruction uses a 16-bit offset, whereas the beqs 
uses a short (8-bit) offset. 

Note that this implementation of as provides an extended set of branch instruc- 
tions which start with the letter j instead of the letter b. If the programmer uses 
the j forms, the assembler computes the offset size for the instruction. See Sec- 
tion 1.1 for the assembler options which control this. 

4.3. Operand Field The operand field of an assembly language statement supplies the arguments to 

the machine instruction or assembler directive. 

as makes a distinction between the <operand field> and individual <operands> 
in a machine instruction or assembler directive. Some machine instructions and 
assembler directives require two or more arguments, and each of these is referred 
to as an “operand”. 



In general, an operand field consists of zero or more operands, and in all cases, 
operands are separated by commas. In other words, the format of an <operand 
field> is: 



/ 






>1 




[ <operand> [ , <operand> ] . 


. 1 




s 






j 



The general format of the operand field for machine instructions is the same for 
all instructions, and is described in Chapter 6. The format of the operand field 
for assembler directives depends on the directive itself, and is included in the 
directive’s description in Chapter 5 of this manual. 

Depending upon the machine instmction or assembler directive, the operand field 
consists of one or more operands. The kinds of objects which can form an 
operand are: 

□ Register operands 

□ Register pairs 

□ Address Operands 

□ String constants 

□ Floating-point constants 

□ Register lists 

□ Expressions 

Register operands in a machine instmction refer to the machine registers of the 
processor or coprocessor. 

Note that register names must be in lower case; as does not recognize register 
names in upper case or a combination of upper case and lower case. 
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Expressions are described in Chapter 3, address operands in Section 6.3, and con- 
stants in Chapter 2. 

4.4. Comment Field as provides the means for the programmer to place comments in the source 

code. There are two ways of representing comments. 

A line whose first non-whitespace character is the hash character ( #) is con- 
sidered a comment. This feature is handy for passing C preprocessor output 
through the assembler. For example, these lines are comments: 



# This is a comment line . 

# And this one is also a comment line. 

s / 



The other way to introduce a comment is when a comment field appears on a line 
with a statement. The comment field is indicated by the presence of the vertical 
bar character ( | ) after the source statement. 

The comment field consists of all characters on a source line following and 
including the comment character. The assembler ignores the comment field. 

Any character may appear in the comment field, with the obvious exception of 
the <newline> character, which starts a new line. 

An assembly language source line can consist of just a comment field. For exam- 
ple, the two statements below are quite acceptable to the assembler: 


I This is a comment field. 

| So is this . 

V > 



4.5. Direct Assignment A direct assignment statement assigns the value of an arbitrary expression to a 

Statements specified identifier. The foimat of a direct assignment statement is: 



s 

<identifier> = <expression> 


\ 


l 


j 



Examples of direct assignments are: 



r 


’N 


vect_size 


= 4 


vectora 


= OxFFFE 


vectorb 


= vectora-vect_size 


CRLF 


= OxODOA 


dtemp 


= dO 1 use register dO as temporary 


v 


J 



Any identifier defined by direct assignment may be redefined later in the pro- 
gram, in which case its value is the result of the last such statement. This is 
analogous to the SET operation found in other assemblers. 

A local identifier may be defined by direct assignment, though this doesn’t make 
much sense. 
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Register identifiers may not be redefined. 

An identifier which has already been used as a label may not be redefined, since 
this would be tantamount to redefining the address of a place in the program. In 
addition, an identifier which has been defined in a direct assignment statement 
cannot later be used as a label. Both situations give rise to assembler error mes- 
sages. 

If the <expression> in a direct assignment is absolute, the identifier is also abso- 
lute, and may be treated as a constant in subsequent expressions. If the <expres- 
sion> is relocatable, however, the < identifier > is also relocatable, and it is con- 
sidered to be declared in the same program section as the expression. 



If the <expression> contains an external identifier, the identifier defined by direct 
assignment is also considered external. For example: 



f 






. globl X 


j X is declared as external identifier 




holder = X 


| holder becomes an external identifier 




L 




> 



assigns the value of X (zero if it is undefined) to holder and makes holder an 
external identifier. External identifiers may be defined by direct assignment. 
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5 






Assembler Directives 



Assembler directives are also known as pseudo operations or pseudo-ops. 
Pseudo-ops are used to direct the actions of the assembler, and to achieve effects 
such as generating data. The pseudo-ops available in as are listed in Table 5-1 
below. 

Table 5 - 1 Assembler Directives 



Pseudo- 

Operation 


Description 


.ascii 


Generates a sequence of ASCII characters. 


.asciz 


Generates a sequence of ASCII characters, terminated by a zero byte. 


.byte 


Generates a sequence of bytes in data storage. 


.bytez 


Generates a sequence of bytes in data storage initialized to zero. 


.word 


Generates a sequence of words in data storage. 


.long 


Generates a sequence of long words in data storage. 


. single 


Generates a sequence of single-precision floating-point constants in 
data storage. 


.double 


Generates a sequence of double-precision floating-point constants in 
data storage. 


.text 


Specifies that generated code be placed in the text control section until 
further notice. 


. data 


Specifies that generated code be placed in the data control section until 
further notice. 


. datal 


Specifies that generated code be placed in the datal control section 
until further notice. 


.data2 


Specifies that generated code be placed in the data.2 control section 
until further notice. 


.bss 


Specifies that space will be reserved in the bss control section until 
further notice. 


. globl 


Declares an identifier as global (external). 


. comm 


Declares the name and size of a common area. 




sun 
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Table 5-1 Assembler Directives — Continued 



Pseudo- 

Operation 


Description 


. lcomm 


Reserves a specified amount of space in the bss control section. 


. skip 


Advances the location counter by a specified amount. 


. align 
. even 


Forces location counter to next one-, two- or four-byte boundary. 
Forces location counter to next word (even-byte) boundary. 


. stab* 


Builds special symbol table entries. These directives are included for 
the benefit of compilers which generate information for the symbolic 
debuggers dbx and dbxtool. 


.proc 


Separates procedures for faster span-dependent instruction resolution. 


. cpid 


Assigns a coprocessor number. 



These assembler directives are discussed in detail in the following sections. 

5.1. . ascii — Generate 
Character Data 



The .ascii directive translates character stnngs into their ASCII equivalents 
for use in the source program. The format of the . ascii directive is: 







\ 


[ <label > : ] .ascii 


"<character string>" 




V 




J 



<character string> contains any character or escape sequence which can appear 
in a character string. Obviously, a newline must not appear within the character 
string. A newline can be represented by the escape sequence \01 2. The following 
examples illustrate the use of the .ascii directive: 



Octal Code Generated: 



Statement: 



150 


145 


154 


154 


157 


040 


. ascii 


"hello there" 


164 


150 


145 


162 


145 








127 


141 


162 


156 


151 


156 


. ascii 


"Warning— \ 007 \ 007 \012 


147 


055 


007 


007 


040 


012 






141 


142 


143 


144 


145 


146 


. ascii 


"abcdefg" 


147 

















®sun 

\r microsystems 
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5.2. . a s c i z — Generate The . a s c i z directive is equivalent to the .ascii directive except that a zero 

Zero-Terminated byte is automatically inserted as the final character of the string. This feature is 

Sequence of Character intended for generating strings which C programs can use. The following exam- 
Data pies illustrate the use of the . asciz directive: 



r 


Octal Code Generated: 




-> 

Statement: 


110 


145 


154 


154 


157 


040 


.asciz "Hello World!" 


127 


157 


162 


144 


041 


000 




124 


150 


105 


040 


107 


162 


.asciz "The Great PROMpkin strikes again!" 


145 


141 


164 


040 


120 


122 




117 


115 


160 


153 


151 


156 




040 


163 


164 


162 


151 


153 




145 


163 


040 


141 


147 


141 




151 


156 


041 


000 






J 



5.3. Directives to Generate The .byte, .word, .long, . single, and . double directives reserve 
Data storage locations and initialize them with specified values. 



The format of the various forms of data generation statements are: 




The . byte directive reserves one byte (8 bits) for each expression in the 
operand field, and initializes it to the low-order 8 bits of the corresponding 
expression. 

The . bytez directive reserves one byte (8 bits) for each expression in the 
operand field, and initializes it to zero. 

The . word directive reserves one word (16 bits) for each expression in the 
operand field, and initializes it to the low-order 16 bits of the corresponding 
expression. 

The . long directive reserves one long word (32 bits) for each expression in the 
operand field, and initializes it to the value of the corresponding expression. 
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The . single directive reserves one long word for each expression in the 
operand field, and initializes it to the low-order 32 bits of the corresponding 
expression. 

The . double directive reserves a pair of long words for each expression in the 
operand field, and initializes them to the value of the corresponding expression. 

Multiple expressions can appear in the operand field of the . byte, . word, 
.long, .single, and . double directives. Multiple expressions must be 
separated by commas. 

5.4. Directives to Switch These statements .text, .data, .bss, .datal,and . data2, change the 
Location Counter ‘control section’ where assembled code is loaded. 

as (and the system linker) view programs as divided into three distinct sections 
or address spaces: 



Space 


Description 


text 


The address space where the executable machine instructions are 
placed. 


data 


The address space where initialized data is placed. The assem- 
bler actually knows about three data areas, namely, data, datal, 
and data2. The second and third data areas are mainly for the 
benefit of compilers and are of minimal interest to the assembly 
language programmer. 

If the -R option is coded on the as command line, it means that 
the initialized data should be considered read-only. It is actually 
placed at the end of the text area. 


bss 


The address space where the uninitialized data areas are placed. 
Also, see the . lcomm directive described below. 



For historical reasons, the different areas are frequently referred to as ‘control 
sections’ (csects for short). 

These sections are equivalent as far as as is concerned, with the exception that 
no instructions or data are generated for the bss section — only its size is com- 
puted and its symbol values are output. 

During the first pass of the assembly, as maintains a separate location counter 
for each section. Consider the following code fragments: 
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code : 


. text 
movw 


dl, d2 


| place next instruction 
| in text section 




grab : 


. data 
. long 


27 


| now generate data in 
| data section 




more : 


. text 
addw 


d2, dl 


| now revert to text 
| section 




hold: 


.data 

.byte 


4 


| now back to data section 





During the first pass, as creates the intermediate output in two separate chunks: 
one for the text section and one for the data section. In the text section, code 
immediately precedes more; in the data section, grab immediately precedes 
hold. At the end of the first pass, as rearranges all the addresses so that the 
sections are sent to the output file in the order: text, data and bss. 

The resulting output file is an executable image file with all addresses correctly 
resolved, with the exception of undefined .globl’sand .comm’s. 

For more information on the format of the assembler’s output file, consult the 
a.out{ 5) entry in the System Programmer’ s Reference Manual. 



5.5. .skip — Advance the The . skip directive reserves storage by advancing the current location counter 
Location Counter a specified amount. The format of the .skip directive is: 



f 






[ <label > : ] 


.skip < size > 




v 




j 



where <size> is the number of bytes by which the location counter should be 
advanced. The .skip directive is equivalent to performing direct assignment 
on the location counter. For instance, a . skip directive like this: 

< ■> 

Table .skip 1000 

V > 



reserves 1000 bytes of storage, with the value of Table equal to the address of the 
first byte. 



5.6. . lcomm — Reserve 
Space in bss Area 



The . lcomm directive is a compact way to get a specific amount of space 
reserved in the bss area. The format of the . lcomm directive is: 



r 


\ 


.lcomm < name >,< size > 




v 


J 



where <name> is the name of the area to reserve, and <size> is the number of 
bytes to reserve. The . lcomm directive specifically reserves the space in the bss 
area, regardless of which location counter is currently in effect. 



esun 

XT microsystems 
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A . lcomm directive like this: 




is equivalent to these directives: 




5.7. . globl — Designate A program may be assembled in separate modules, and then linked together to 

an External Identifier form a single executable unit. See the ld(l) command in the SunOS Reference 

Manual. 

External identifiers are defined in each of these separate modules. An identifier 
which is defined (given a value) in one module may be referenced in another 
module by declaring it external in both modules. 

There are two forms of external identifiers, namely, those declared with the 
. globl and those declared with the . comm directive. The . comm directive is 
described in the next section. 



External symbols are declared with the . globl assembler directive. The format 
is: 




For example, the following statements declare the array TABLE and the routine 
SRCH as external symbols, and then define them as locations in the current con- 
trol section: 



r 

.globl 


-\ 

TABLE, SRCH 


TABLE: .word 


o 

o 

o 

o 

o 


SRCH : movw 


TABLE, dO 


etc. 


> 



5.8. . comm — Define Name The . comm directive declares the name and size of a common area, for compati- 
and Size of a Common bility with FORTRAN and other languages which use common. The format of the 
Area . comm statement is: 




where <name> is the name of the common area, and <constantexpression> is 
the size of the common area. The . comm directive implicitly declares the 
identifier <name> as an external identifier. 
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5.9. .align — Force 
Location Counter to 
Particular Byte 
Boundary 



as does not allocate storage for common symbols; this task is left to the linker. 
The linker computes the maximum declared size of each common symbol (which 
may appear in several load modules), allocates storage for it in the final bss sec- 
tion, and resolves linkages. If, however, <name> appears as a global symbol 
Gabel) in any module of the program, all references to <name> are linked to it, 
and no additional space is allocated in the bss area. 



The .align directive advances the location counter to the next one-, two- or 
four-byte boundary, if it is not currently on such a boundary. Intervening bytes 
are filled with zeros. The format of the . align directive is: 



r 


\ 


.align < size > 




1 


J 



where <size> must be an assembler expression which evaluates to 1,2 or 4. 

This directive is necessary because word and long word data values must lie on 
even-byte boundaries, because machine instructions must start on even-byte 
boundaries, and because the MC68020 is much more efficient if word and long 
word data are on even-byte and four-byte boundaries, respectively. 



5.10. . even — Force The . even directive advances the location counter to the next even-byte boun- 

Location Counter to dary, if its current value is odd. This directive is necessary because word and 

Even Byte Boundary long word data values must lie on even-byte boundaries, and also because 

machine instructions must start on even-byte boundaries. . even is equivalent 
to . align 2. 







— 




. even 




v 




J 



5.11. . s t abx — Build 

Special Symbol Table 
Entry 



The . st abx directives are provided for the use of compilers which can generate 
information for the symbolic debuggers dbxmd dbxtool. The directives 
.stabs, . stabd, and . stabn build various types of symbol table entries. 

The .stab directives have the following forms: 



— 


— 


. stabs name , type , 0 , desc , value 




.stabn type , 0 , desc , value 






J 



or 



( 




\ 


. stabd 


type, 0,desc 




v 




J 
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The . stabs directives are used to describe types, variables, procedures, and so 
on, while the . stabn directives convey information about scopes and the map- 
ping from source statements to object code. 

A . stabd directive is identical in meaning to a corresponding . stabn direc- 
tive with the value field set to (dot), which the assembler uses to mean the 
current location. Most of the needed information, for example symbol name and 
type structure, is contained in the name field. The type field identifies the type of 
symbolic information, for example source file, global symbol, or source line. 

The desc field specifies the number of bytes occupied by a variable or type or the 
nesting level for a scope symbol. The value field specifies an address or an 
offset. 



5.12. . proc — Separate 
Procedures for Span- 
Dependent 
Instruction 
Resolution 



The . proc directive separates procedures for span-dependent instruction resolu- 
tion. In its absence the assembler does span-dependent instruction resolution 
over entire files. If .proc is used, the resolution is done between occurrences of 
the directive and between either end of the file and its nearest occurrences. Since 
the algorithm used requires more than linear time, using .proc can save 
significant time for large assemblies. Branch instructions must not cross . proc 
directives, although calls may. 





■\ 


.proc 




l 





5.13. 



.cpid — Name 
Default Coprocessor 



ID 



The .cpid directive gives the assembler a coprocessor id value to use for 
MC6888 1 instructions that don’t have an explicit coprocessor id given. The 
form of the directive is 



r 


\ 


.cpid < id > 




V 


J 



If no . cpid directive is given in a program, a value of 1 is assumed. Since no 
Sun systems currently have more than one coprocessor, you don’t need to use 
this directive. 
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Instructions and Addressing Modes 



This chapter describes the conventions used in as to specify instruction 
mnemonics and addressing modes. The information in this chapter is specific to 
the machine instructions and addressing modes of the MC68010 and MC68020 
microprocessors and the MC6888 1 coprocessor. See Appendix C for informa- 
tion on the Sun FPA’s instructions set and addressing modes. 

6.1. Instruction Mnemonics The instruction mnemonics that as uses are based on the mnemonics described 

in the relevant Motorola processor manuals. However, as deviates from them in 
several areas. 

Most of the MC68010 and MC68020 instructions can apply to byte, word or long 
operands. Instead of using a qualifier of . b, . w, or . 1 to indicate byte, word, or 
long as in the Motorola assembler, as appends a suffix to the normal instruction 
mnemonic, thereby creating a separate mnemonic to indicate which length 
operand was intended. 

For example, there are three mnemonics for the or instruction: orb, orw, and 
or 1, meaning or byte, or word, and or long, respectively. 

Instruction mnemonics for instructions with unusual opcodes may have addi- 
tional suffixes. Thus in addition to the normal add variations, there also exist 
addqb, addqw and addql for the add quick instruction. 

Branch instructions come in two flavors for the MC68010, byte (or short) and 
word, and an additional flavor, long, for the MC68020. Append the suffix s to 
the word mnemonic to specify the short version of the instruction. For example, 
beq refers to the word version of the Branch if Equal instruction, beqs refers to 
the short version, while beql refers to the long version. 

6.2. Extended Branch In addition to the instructions which explicitly specify the instruction length, a s 

Instruction Mnemonics supports extended branch instructions, whose names are, in most cases, con- 
structed from the word versions by replacing the b with j . 

If the operand of the extended branch instruction is a simple address in the text 
segment, and the offset to that address is sufficiently small, as automatically 
generates the corresponding short branch instruction. 

If the offset is too large for a short branch, but small enough for a branch, the 
corresponding branch instruction is generated. If the operand references an 
external address or is complex (see next paragraph), the extended branch 
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instruction is implemented either by a jmp or j sr (for j ra or jbsr), or (for 
the MC68010) by a conditional branch (with the sense of the condition inverted) 
around a jmp for the extended conditional branches and (for the MC68020) the 
corresponding long branch. 

The extended mnemonics should only be used in the text segment — if they are 
used in the data segment, the most general form of the branch is generated. 

In this context, a complex address is either an address which specifies other than 
normal mode addressing, or a relocatable expression containing more than one 
relocatable symbol. For instance, if a, b and c are symbols in the current seg- 
ment, the expression a+b-c is relocatable, but not simple. 

Consult Appendix B for a complete list of the instruction opcodes. 

6.3. Addressing Modes Table 6-1 below describes the addressing modes that asrecognizes. Note that 

certain modes are not valid for the MC68010. The notations used in this table 
have these meanings: 



Notation 


Meaning 


an 


An address register. 


dn 


A data register. 


r i 


Either a data register or an address register. 


f i 


A floating-point register. 


d 


A displacement, which is a constant expression in as. In 
MC68020 mode, a length specifier ( : L, described below) may be 
appended to the displacement. Any forward or external refer- 
ences require the length specifier to be : 1. All other references 
permit either : 1 or : w or nulls. 


L 


The index register’s length. This may be either long (1) or word 
(w) or null. If the only value permitted by a particular addressing 
mode or category is 1 or w, then L will be replaced by the 
appropriate value in the table notation. 


s 


A scale factor that may be used to multiply the index register’s 
length. The scale factor may have a value of 1, 2, 4, or 8. 



The table notation of two or three items separated by colons, such as r/:L: s, 
indicate items that may be optional. In that particular case, you may not specify 
: s unless you have specified :L, which you may not specify unless you have 
specified r i. The items in the list must appear in the order given in the notation 
of the tables that follow. 

In the table where both d and d’ are specified, d corresponds to a MC68020 outer 
displacement and d’ corresponds to a MC68020 base displacement. 

xxx refers to a constant expression. 
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Certain instructions, particularly move, accept a variety of special registers 
including: 



Name 


Register 


sp 


the stack pointer, which is equivalent to a 7 


sr 


the status register 


cc 


the condition codes of the status register 


usp 


the user mode stack pointer 


pc 


the program counter 


sf c 


the source function code register 


df c 


the destination function code register 


fpcr 


the floating-point control register 


fpsr 


the floating-point status register 


fpiar 


the floating-point instruction address register 



The memory-indirect and program counter memory-indirect addressing modes 
listed in the following tables are usable only with the MC68020. 

In each of these addressing modes, up to four user-specified values are used to 
generate the final operand address: 

□ base register 

□ base displacement 

□ index register 

□ outer dispacement 

All four user-specified values are optional. Both base and outer displacements 
may be null, word or long. When a displacement is null, or an element is 
suppressed, its value is taken as zero in the effective address calculation. 

In the case of memory-indirect addressing, an address register ( an) is used as a 
base register, and its value can be adjusted by an optional base displacement (d’). 
An index register (r 0 specifies an index operand (ri : L : s) and finally, an outer 
displacement ( d ) can be added to the address operand, yielding the effective 
address. 

Program counter memory-indirect mode is exactly the same. The only difference 
is that the program counter is used as the base register. 

Some examples of these addressing modes follow: 
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r 




a n@ (d' : L, ri:L:s)@(d:L) 




an@(d:L)@(d’ :L,ri:L:s) 




an@@ 




an@(d:L)@ 




an@(d’ :L,ri:L:s)@ 




pc@@ 




pc@(d:L)@ 




pc@(d’ :L,ri:L:s)@(d:L) 




pc@(d:L)@(d! :L,ri:L:s) 




@(d:L)@ 




@(d’ :L,ri:L:s)@(d:L) 




@(d:L)@(d’ :L,ri:L:s) 




@(d’ :L,ri:L:s)@ 




V 


J 



In the table below, note that the notation ri/rj means ri and r j, while ri_rj means ri 
through rj. 



Table 6-1 Addressing Modes 



Mode 


Notation 


Example 


Register 


an, dn, sp, pc, cc, sr, usp 


movw a3 , d2 


Register Deferred 


an@ 


movw a30,d2 


Register List 


ri-rj or ri/rj 


movem a0-a4, a60- 


FPA register 


fpa i 


fpmoves fpal,d2 


Floating-Point Register 


fp i 


f moves fpl,a30(24) 


(MC68881 only) 






Postincrement 


a n@+ 


movw a30+,d2 


Predecrement 


an@- 


movw a30-,d2 


Displacement 


an@ ( 4 ) 


movw a30(24),d2 


Word Index 


a n@ ( d , ri: w) 


movw a30(16, d2:w),d3 


Long Index 


an@ ( d , ri: 1) 


movw a30(16, d2:l),d3- 


Absolute Short 


xxx:w 


movw 1 4 : w , d2 


Absolute Long 


XXXll 


movw 1 4 : 1 , d2 


PC Displacement 


pc@ ( d ) 


movw pc0(2O),d3 


PC Word Index 


pc0 (4, ri: w) 


movw pc0(14, d2:w),d3 


PC Long Index 


pc0 (4, ri: 1) 


movw pc0(14, d2:l),d3 


PC-Memory Indirect 


pc0 (d f : L, ri : L : s ) 0 (d:L) 


movl pc0 (2 :w, d4 : w : 4) 0 (14 : 1) , d3 


Pre-Indexed (68020) 






PC-Memory Indirect 


pc0 (d:L)0 (d' :L,ri:L:s) 


movl pc0 (d: 1) 0 (3 : w, d2 : 1 : 4 ) , d3 


Post-Indexed (68020) 






Memory Indirect 


a«0 (4’ :L, ri:L:s) 0 (d:L) 


movl al0 (d:L,d2 :1 :4) 0 (14 :w) 


Pre-Indexed (68020) 






Memory Indirect 


an0 (4: L) 0 (d' :L, ri:L: s) 


movl a20 (2 :w) 0 (14 :w, d4 : w: 2) 


Post-Indexed (68020) 
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Table 6-1 Addressing Modes — Continued 



Mode 


Notation 


Example 


Normal 


identifier 


movw widget , d3 


Immediate 


#xxx 


mow #27+3, d3 



Normal mode assembles as PC-relative if the assembler can determine that this is 
appropriate, otherwise it assembles as either absolute short or absolute long, 
under control of the -d2 command line option. 

The Motorola manuals present different mnemonics (and in fact different forms 
of the actual machine instructions) for instructions that use the literal effective 
address as data instead of using the contents of the effective address. For 
instance, they use the mnemonic adda for add address, as does not make 
these distinctions because it can determine the type of opcode required from the 
form of the operand. Thus an instruction of the form: 



r 

avenue: .word 0 


\ 


addl #avenue,aO 

k. 


j 


assembles to the add address instruction because 
address register. 


as can determine that aO is an 


/■ 

right_now: = 40000 


'V 


addl #right_now, dO 

k 


j 



assembles to an add immediate instruction because as can determine that 
right now is a constant. 

Because of this determination of operand forms, some of the mnemonics listed in 
the Motorola manuals are missing from the set of mnemonics that as recognizes. 

Certain classes of instructions accept only subsets of the addressing modes 
above. For example, the add instruction does not accept a PC-relative address as 
a destination, and register lists may be used only with the movem and fmovem 
instructions. 

as tries to check all these restrictions and generates the illegal operand error 
code for instructions that do not satisfy the address mode restrictions. 

The next section describes how the address modes are grouped into addressing 
categories. 
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6.4. Addressing Categories The processors group the effective address modes into categories derived from 

the manner in which they are used to address operands. Note the distinction 
between address modes and address categories. There are 14 addressing modes 
in the MC68010 and 18 in the MC68020, and they fall into one or more of four 
addressing categories. The addressing categories are defined here, followed by a 
table summarizing the grouping of the addressing modes into categories. Note 
that register lists can be used only by the movem and fmovem instructions. 



Category 


Meaning 


Data 


means that the effective address mode is used to refer to data 
operands such as a d register or immediate data. 


Memory 


means that the effective address mode can refer to memory 
operands. Examples include all the a-register indirect address 
modes and all the absolute address modes. 


Alterable 


means that the effective address mode refers to operands which 
are writeable (alterable). This category takes in every addressing 
mode except the PC-relative addressing modes and the immedi- 
ate address mode. 


Control 


means that the effective address mode refers to memory 
operands with no explicit size specification. 



Some addressing categories can be intersected to make more restrictive ones. 
For example, the Motorola MC68010 manual mentions the Data Alterable 
Addressing Mode to mean that the particular instruction can only use those 
modes which provided data addressing and are alterable as well. 



Table 6-2 Addressing Categories 



Addressing 

Mode 


Assembler 

Syntax 


Data 


Memory 


Control 


Alterable 


MC68020 

Only 


Register Direct 


an, dn, sp, pc, 
cc, sr, usp 


X 






X 




A-Register Indirect 


an@ 


X 


X 


X 


X 




A~Register Indirect 
with Displacement 


an@ (d: L) 


X 


X 


X 


X 


X 


A-Register Indirect 
with Word Index 


an0 (d:L, rz':w:s) 


X 


X 


X 


X 


X 


A-Register Indirect 
with Long Index 


an0 (d:L,rz:l:s) 


X 


X 


X 


X 


X 


A-Register Indirect 
with Post Increment 


an0 + 


X 


X 




X 




A-Register Indirect 
with Pre Decrement 


an0- 


X 


X 




X 
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Table 6-2 Addressing Categories — Continued 



Addressing 

Mode 


Assembler 

Syntax 


Data 


Memory 


Control 


Alterable 


MC68020 

Only 


A-Register Indirect 
with Displacement 


a n@ (d) 


X 


X 


X 


X 




A-Register Indirect 
with Word Index 


a (d, ri:w) 


X 


X 


X 


X 




A-Register Indirect 
with Long Index 


an 6 ( d , ri:l) 


X 


X 


X 


X 




Memory -Indirect 
Post-Indexed 


an@ (d:L) @ (d/ : L, ri: L : s) 


X 


X 


X 


X 


X 


Memory -Indirect 
Pre-Indexed 


an@ (d f :L, rz:L: s) @ (d:L) 


X 


X 


X 


X 


X 


Absolute Short 


xxx : w 


X 


X 


X 


X 




Absolute Long 


xxx: 1 


X 


X 


X 


X 




PC -relative 


pc@ (d) 


X 


X 


X 






PC -Indirect 
with Displacement 


pc@ (d: L) 


X 


X 


X 




X 


PC -relative with 
Word Index 


pc@ (d, ri: w) 


X 


X 


X 






PC -Indirect with 
Word Index 


pc@ (d: L, ri : w : s ) 


X 


X 


X 




X 


PC -relative 
with Long Index 


pc@ (d, ri:l) 


X 


X 


X 






PC -Indirect with 
Long Index 


pc@ (d: L, r/ : 1 : s ) 


X 


X 


X 




X 


PC -Memory Indirect 
Post-Indexed 


pc@ (d:L) @ (d f :L, r/:L:s) 


X 


X 


X 


X 


X 


PC -Memory Indirect 
Pre-Indexed 


pc@ (d' : L, ri : L : s) @ (d: L) 


X 


X 


X 


X 


X 


Immediate Data 


#nnn 


X 


X 
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as Error Codes 

as Error Codes 51 

A.l. Usage Errors 51 

A.2. Assembler Error Messages 51 



A 









as Error Codes 



A.l. Usage Errors ~ 

& Cannot open output file 

The specified output file cannot be created. Check that the permissions 

allow opening this file. 



Cannot open source file 

The assembler cannot open the specified source file. Check the spelling, that 
the pathname supplied is correct, and that you have read permission for the 
file. 



No input file 

One or more input files must be specified — as cannot accept the output of 
a pipe as its input. 



Too many file names given 

The assembler cannot cope with more than one source file. Break the job 
into smaller stages. 



Unknown option ‘x’ ignored 

as does not recognize the option x. Valid options are listed in Section 1.1 of 
this manual. 

A.2. Assembler Error If as detects any errors during the assembly process, it prints out a message of 

Messages the form: 



r 

as: error ( <line_no> ) : <error_code> 




l I 


J 



Error messages are sent to standard error. Here is a list of as error codes, and 
their possible causes. 



Illegal .align 

The expression following a . align evaluates to some value other than 1, 2 
or 4. 




51 
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Invalid assignment 

An attempt was made to redefine a label with a direct assignment statement. 



Invalid Character 

An unexpected character was encountered in the program text. 



Invalid Constant 

An invalid digit was encountered in a number. For example, using an 8 or 9 
in an octal number. Also happens when an out-of-range constant operand is 
found in an instruction — for example: 



— 






\ 




addq 


#200, dO 






asll 


#12, dO 




V 






j 



Invalid opcode 

The assembler did not recognize an instruction mnemonic. Probably a 
misspelling. 



Invalid operand 

The operand used is not consistent with the instruction used — for example: 

. • > 
addqb #l,a5 

S > 

is an invalid combination of instruction and operand. Check the instruction 
set descriptions for valid combinations of instructions and operands. 



Invalid Operator 

Check the operand field for a bad operator. The operators that as recog- 
nizes are plus ( + ), minus ( - ), negate or one ’s complement ( ~ ), multiply 
(*), and divide (/). 



Invalid register expression 

A register name was found where one should not appear — for example: 



r 




>1 




addl #d0,_there 




l, 







Invalid Register List 

The register list in a movem or fmovem instruction is malformed. Note 
that the list must contain more than one register name: to express a list con- 
taining just a single register, you must write its name twice separated by a 
slash, e.g. fpO/fpO." 
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Invalid string 

An invalid string was encountered in an .ascii or .asciz directive. 

□ Make sure the string is enclosed in double quotes. 

□ Remember that you must use the sequence V* to represent a quote inside 
a string. 



Invalid symbol 

An operand that should be a symbol is not — for example: 



( 




■\ 




.globl 3 




v 







because the constant 3 is not a symbol. 



Invalid Term 

The expression evaluator could not find a valid term: a symbol, constant or 
<expression> . 

An invalid prefix to a number or a bad symbol name in an operand gen- 
erates this message. 



Line too long 

A statement was found which has more than 4096 characters before the new- 
line character. 



Missing close-par en ’)’ 

An unmatched *(* was found in an expression. 



Multiply defined symbol 

□ An identifier appears twice as a label. 

□ An attempt to redefine a label using a direct assignment statement. 

□ An attempt to use, as a label, an identifier which was previously defined 
in a direct assignment statement. 

Multiply Defined Symbol ( Phase Error) 

This rarely occurring message indicates an inconsistency in the assembler. 
Report it to Sun Microsystems Customer Support if it occurs. 



N on-relocatable expression 

If an expression contains a relocatable symbol (a label, for instance), the 
only operations that can be applied to it are the addition of absolute expres- 
sions or the subtraction of another relocatable symbol (which produces an 
absolute result). 
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Odd address 

The previous instruction or pseudo-op required an odd number of bytes and 
this instmction requires word alignment. This error can only follow an 
.ascii, an .asciz,a .byte, ora . skip pseudo-operation. 

NOTE Use a .even directive to ensure that the location counter is forced to a 16-bit 
boundary. 

Offset too large 

The instruction is a relative addressing instruction and the displacement 
between this instmction and the label specified is too large for the address 
field of the instmction. 

Out of strings space 

No more room is left in the assembler’s internal string table. Divide the pro- 
gram into smaller portions; assemble portions of the program separately, 
then bind them together using the linker. 



Register out of range 

In the FPA’s dot product, matrix move and transpose instructions when the 
register specified does not fall within the specified range, then this error is 
reported. Note that for most instructions where one operand is an effective 
address, the register range is 0 to 15. If all operands are FPA registers, the 
register range is 0 to 3 1 . For constant RAM registers, the range is 0 to 5 1 1 . 
This type of error would probably also cause the Invalid operand error to be 
reported. 



Stab storage exceeded 

No more room is left in the assembler’s symbol table for debug information. 
Cut the program into smaller portions; assemble portions of the program 
separately, then bind them together using the linker. 



Symbol storage exceeded 

No more room is left in the assembler’s symbol table. Divide the program 
into smaller portions; assemble portions of the program separately, then bind 
them together using the linker. 



Symbol Too Long 

A local label reference longer than one digit was found. 
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Undefined. L- symbol 

This is a warning message. A symbol beginning with the letter ‘L’ was used 
but not defined. It is treated as an external symbol. Compiler-generated 
labels usually start with the letter ‘L’ and should be defined in this assembly. 
The absence of such a definition usually indicates a compiler code genera- 
tion error. This message is also generated by the use of symbols such as n$ 
if n$ has not been defined. 



Unqualified forward reference 

The displacement field in an MC68020 based/indexed address mode con- 
tains an unqualified forward reference. Note that the displacement in a 
based/indexed address mode for the MC68020 instruction set can contain a 
forward or external reference only if the length specifier is present. The 
length specifier should be : 1 Gong). This type of error would probably also 
cause Multiply defined symbol (Phase error). 



Undefined Symbol 

A label reference to an undefined local label was found. 



Wrong number of operands 

Check Appendix B for the correct number of operands for the current 
instruction. 
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B 

n " ' " 711 L 

>X , XWfeX< , X , XwXW , />!'WWXW; , X , W , X , X , Xv! , l , X^>A%%WWW!WX< , !WX<W^ 

List of as Opcodes 



This appendix is a list of the instruction mnemonics accepted by as, grouped 
alphabetically. The list is divided into two tables, the first covers the MC680x0 
processor’s instructions, the second covers the MC6888 1 floating-point 
processor’s instructions. For more information about floating-point program- 
ming, see the Floating-Point Programmer’ s Guide. 

Each entry describes the following things: 

□ The mnemonics for the instruction, 

□ The generic name of the instruction, 

□ The assembly language syntax and the variations on the instruction, 

□ Whether the instmction is specific to the MC68020, or has extended capabil- 
ities on the MC68020 compared to the MC68010. 

The syntax for as machine instructions differs somewhat from the instmction 
layouts and categories shown in the Motorola processor manuals. For example, 
as provides a single set of mnemonics for add (add binary), adda (add 
address), and addi (add immediate), differentiated only by the length of the 
operands. In general, as selects the appropriate instmction from the form of the 
operands. 

Here is a brief explanation of the notations used below. 

□ An instmction of the form add* in the assembly language syntax column 
means that the instmction is coded as addb, addw, addl, etc. 

□ An operand field of a« means any A-register. 

□ An operand field of dn means any D-register. 

□ An operand field of r n means any A- or D-register. 

□ An operand field of fn means any floating-point register. 

□ An operand field of cn means any control register. 

□ An operand field of ea means an effective address designated by one of the 
permissible addressing modes. Consult the relevant Motorola processor 
manual for details of the allowed addressing modes for each instmction. 
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□ An operand field of vector means an exception vector location. 

□ An operand field of #data means an immediate operand. 

□ Other special registers such as cc (condition code register) and sr (status 
register) are specifically indicated where appropriate. 

The MC68020 provides a set of bit-field manipulating instructions that don’t 
exist on the MC68010. Their notation includes a bit field specifier of the form 
{ojfsetiwidth} , where the offset denotes the beginning of the bit field in the word 
and the width is the number of bits in the field. 

Offset values are counted from the high-order bit, as 0, to the low-order bit, as 
31. 

NOTE This ordering is the reverse of the convention used in the bchg, bclr, bset, 
and bt s t instructions. 

Offset and width may be either constants or data registers. For example: 

□ bf ins d0,a5@ (4) (#0 :#9} 

□ bfexta a50 (4) {d0 : #8 } , d7 

In the table that follows, the processor is assumed to be the MC68010 unless 
specifically stated otherwise. 



Table B-l List ofMC680x0 Instruction Codes 



Mnemonic 


Operation Name 




Syntax 


Processor 


abed 


add decimal with extend 


abed 


dy,6x 








abed 


ay@-,aX@- 




addb 


add binary 


addX 


ea, d n 




addw 




addX 


dn,ea 




addl 




addX 


ea, art (except addb) 








addX 


tfdata, ea 




addqb 


add quick 


addqX 


tfdata, ea 




addqw 










addql 










addxb 


add extended 


addxX 


dy, dX 




addxw 




addxX 


ay@-, aX@- 




addxl 










andb 


logical and 


andX 


ea, d n 




andw 




andX 


dn,ea 




andl 




andX 


tfdata, d n 




aslb 


arithmetic shift left 


aslX 


dX, dy 




aslw 




a slX 


%data, dy 




asll 




a slX 


ea 
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T able B - 1 List ofMC680x0 Instruction Codes — Continued 



Mnemonic 


Operation Name 




Syntax 


Processor 


asrb 


arithmetic shift right 


asrX 


dX, dy 




asrw 




asrX 


%data , dy 




asrl 




asrX 


ea 




bcc 


branch conditionally 


bccX 


label 




bccl 








MC68020 


bees 










bchg 


test a bit and change 


bchg 


d/i, ea 








bchg 


%data r ea 




bclr 


test a bit and clear 


bclr 


d n, ea 








bclr 


%data, ea 




bkpt 


breakpoint 


bkpt 


\data 


MC68020 


bset 


test a bit and set 


bset 


d n, ea 








bset 


%data, ea 




btst 


test a bit 


btst 


d n, ea 








btst 


%data, ea 




bf chg 


test a bit field and change 


bf chg 


ea{ offset width} 


MC68020 


bfclr 


test a bit field and clear 


bfclr 


ea{ offset width} 


MC68020 


bfexts 


extract a bit field signed 


bfexts ea{ offset width } , d n 


MC68020 


bfextu 


extract a bit field unsigned 


bfextu ea{ offset width} , d n 


MC68020 


bfffo 


find first one in bit field 


bfffo 


ea{ offset width } , d n 


MC68020 


bfins 


insert a bit field 


bfins 


d/i, ea{ off set width} 


MC68020 


bf set 


test a bit field and set 


bf set 


ea{ offset width} 


MC68020 


bftst 


test a bit field 


bftst 


ea{ offset width} 


MC68020 


bes 


branch carry set 


bcsX 


ea 




bcsl 








MC68020 


bess 










beq 


branch on equal 


beqX" 


ea 




beql 








MC68020 


beqs 










bge 


branch greater or equal 


bgaX 


ea 




bgel 








MC68020 


bges 










bgt 


branch greater than 


bgtX 


ea 




bgtl 








MC68020 


bgts 
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Table B - 1 List ofMC680x0 Instruction Codes — Continued 



Mnemonic 


Operation Name 


Syntax 


Processor 


bhi 


branch higher 


bhiX ea 




bhil 






MC68020 


bhis 








ble 


branch less than or equal 


bleX ea 




blel 






MC68020 


bles 








bis 


branch lower or same 


blsX ea 




blsl 






MC68020 




branch less than 


bltX ea 












EBI 










branch minus 


bmiX ea 




















■ 


branch not equal 


bneX ea 










MC68020 


EH 










branch positive 


bplX ea 




1 






MC68020 










gw 


branch always 


braX label 










MC68020 










bsr 


subroutine branch 


bsrX label 




bsrl 






MC68020 


bsrs 








bvc 


branch overflow clear 


bvcX ea 




bvcl 






MC68020 


bvcs 








bvs 


branch overflow set 


bvsX ea 




bvsl 




bvsl 


MC68020 


bvss 








callm 


call module 


callm %data, ea 


MC68020 


cas2b 


compare & swap with operand 


cas2X del : dc2 , dul : du2 , (rnl) : (m2) 


MC68020 


cas21 






MC68020 


cas2w 






MC68020 


casb 


compare & swap with operand 


casX dc, d«, ea 


MC68020 


casl 






MC68020 


casw 






MC68020 
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Table B - 1 List ofMC680x0 Instruction Codes — Continued 



Mnemonic 


Operation Name 




Syntax 


Processor 




check register against bounds 


chkX 


ea, dn 


MC68020 

MC68020 

MC68020 


chk2b 

chk21 

chk2w 


check register against bounds 


chk2X 


ea, rn 


MC68020 

MC68020 

MC68020 


clrb 

clrw 

clrl 


clear an operand 


clrX 


ea 






compare register against bounds 


cmp2X 


ea, rn 


MC68020 

MC68020 

MC68020 


cmpmb 

cmpmw 

cmpml 


compare memory 


cmpmX 


ay8 + , aX@+ 




cmpb 

cmpw 

cmpl 


arithmetic compare 


cmpX 

cmpX 


ea, dn 
%data, ea 




dbcc 


decrement & branch on carry clear 


dbcc 


dn, label 




dbcs 


" on carry set 


dbcs 


dn, label 




dbeq 


" on equal 


dbeq 


dn, label 




dbf 


" on false 


dbf d n, label 




dbge 


" on greater than or equal 


dbge 


dn, label 




dbgt 


" on greater than 


dbgt 


dn, label 




dbhi 


" on high 


dbhi 


dn, label 




dble 


" on less than or equal 


dble 


dn, label 




dbls 


" on low or same 


dbls 


dn, label 




dblt 


" on less than 


dblt 


dn, label 




dbmi 


" on minus 


dbmi 


dn, label 




dbne 


" on not equal 


dbne 


dn, label 




dbpl 


" on plus 


dbpl 


dn, label 




dbra 


" always (same as dbf) 


dbra 


dn, label 




dbt 


" on True 


dbt d n, label 




dbvc 


" on overflow clear 


dbvc 


dn, label 




dbvs 


" on overflow set 


dbvs 


dn, label 




divs 


signed divide 


divs 


ea, dn 




divsl 




divsX 


ea, dn 


MC68020 


divsll 




divsX 

divsX 


ea, d q 
ea, dr :dq 


MC68020 

MC68020 


divu 


unsigned divide 


divu 


ea, dn 




divul 




divuX 


ea, dn 


MC68020 
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Table B-l List ofMC680x0 Instruction Codes — Continued 



Mnemonic 



divuw 

divull 



Operation Name 



Syntax 



divuX ea,dn 


divuX ea,dq 


divuX ea,dr:dq 


divull ea,dr:dq 


eorX 


dn,ea 


eorX 


idata, ea 


eorb 


%data, cc 


eorw 


%daia, sr 


exg 


xx, ry 


extbl dn 


extX 


dn 


jmp 


ea 


jsr 


ea 


jcc 


ea 


jcs 


ea 


jeq 


ea 


jge 


ea 


jgt 


ea 


jhi 


ea 


jle 


ea 


jls 


ea 


jit 


ea 


jmi 


ea 


jne 


ea 


jpl 


ea 


jra 


ea 


jbsr 


ea 


jvc 


ea 


jvs 


ea 



Processor 



MC68020 

MC68020 

MC68020 

MC68020 



extbl 

extw 

extl 



link 

linkl 






logical exclusive or 



exchange registers 



sign extend 



jump 

jump to subroutine 
jump carry clear 
jump on carry 
jump on equal 
jump greater or equal 
jump greater than 
jump higher 

jump less than or equal 

jump lower or same 

jump less than 

jump minus 

jump not equal 

jump positive 

jump always 

jump to subroutine 

jump no overflow 

jump on overflow 



load effective address 



link and allocate 



logical shift left 



logical shift right 




lea ea,an 



link an, %disp 
linkl an, %disp 



Is IX dr,dy 
Is IX %data,dy 
lslX ea 



lsrX dr,d y 
IsrX %data,dy 
lsrX ea 



movX ea, ea 
movX %data, dn 




MC68020 



MC68020 
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Table B-l List of MC680x0 Instruction Codes — Continued 



Mnemonic 


Operation Name 


Syntax 


Processor 


movw 


move from condition code register 


movw cc, ea 




movw 


move from status register 


movw sr,ea 




move 


move to/from control register 


move in, cr 








move cr, r n 




movemi 


move multiple registers 


move mX # mask , ea 




movemw 




movemX ea,%mask 
movemX ea,reglist 
movemi reglist, ea 




movepl 


move peripheral 


movepX dn, an0 ( d ) 




movepw 




movepX a «6 (d) , dn 




moveq 


move quick 


moveq %data,6n 




movsb 


move to /from address space 


movsX r n,ea 




movsw 




movsX ea, in 




movsl 








muls 


signed multiply 


muls ea,dn 




mulslw 




mulsX ea,dl 


MC68020 


mulsll 




mulsX ea,dhzdl 


MC68020 


mulu 


unsigned multiply 


mulu ea,dn 




mulul 




muluX ea,dl 


MC68020 






muluX ea,dhzdl 


MC68020 


nbed 


negate decimal with extend 


nbed ea 






negate binary 


negX ea 




negw 
















negxb 

negxw 

negxl 


negate binary with extend 


negxX ea 




nop 


no operation 


nop 




notb 


logical complement 


notX ea 




notw 








notl 








orb 


inclusive or 


orX ea, d n 




orw 




orX dn, ea 




orl 




or idata,ea 

orb $data,cc 
orw %data,sr 




pack 


pack 


pack aX@-, ay@-, it data 


MC68020 






pack dX, d y , %data 


MC68020 


pea 


push effective address 


pea ea 
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Table B - 1 List ofMC680x0 1 instruction Codes — Continued 



Mnemonic 


Operation Name 


Syntax 


Processor 


reset 


reset device 


reset 




rolb 


rotate left 


roLY dr, dy 




rolw 


rotate left 


rolY idata, dy 




roll 




rolX ea 




rorb 


rotate right 


roxX dx, dy 




rorw 




rorX idata, dy 




rorl 




rorX ea 




roxlb 


rotate left with extend 


roxlX dx,dy 




roxlw 




roxlX idata, dy 




roxll 




roxlX ea 




roxrb 


rotate right with extend 


roxrX dx, dy 




roxrw 




roxxX idata, dy 




roxrl 




roxrX ea 




rtd 


return and deallocate parameters 


rtd #data 




rte 


return from exception 


rte 




rtm 


return from module 


rtm r n 


MC68020 


rtr 


return and restore codes 


rtr 




rts 


return from subroutine 


rts 








rts in 




sbcd 


subtract decimal with extend 


sbcd dy, dx 
sbcd ay@-, aX@- 




stop 


halt machine 


stop #xxx 




subb 


arithmetic subtract 


sub^f ea , d n 




subw 




subX dn,ea 
subA ea, an 




subl 




subX idata,ea 




St 


set all ones 


st ea 




sf 


set all zeros 


sf ea 




shi 


set high 


shi ea 




sis 


set lower or same 


sis ea 




see 


set carry clear 


see ea 




scs 


set carry set 


scs ea 




sne 


set not equal 


sne ea 




seq 


set equal 


seq ea 




SVC 


set no overflow 


sve ea 




svs 


set on overflow 


svs ea 




spl 


set plus 


spl ea 




smi 


set minus 


smi ea 




sge 


set greater or equal 


sge ea 




sit 


set less than 


sit ea 




sgt 


set greater than 


sgt ea 




sle 


set less than or equal 


sle ea 
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T able B - 1 List ofMC680x0 Instruction Codes — Continued 



Mnemonic 


Operation Name 


Syntax 


Processor 


subqb 

subqw 

subql 


subtract quick 
subtract quick 


subqX %data,ea 




subxb 

subxw 

subxl 


subtract extended 


subxX dy, dx 
subxX ay@ - , aX0 - 




swap 


swap register halves 


swap dn 




tas 


test operand then set 


tas ea 




trap 


trap 


trap # vector 




trapcc 


trap on carry clear 


trapccX 


MC68020 


trapccl 

trapccw 




trapccX %data 


MC68020 

MC68020 


trapes 


trap on carry set 


trapesx 


MC68020 


t rape si 
trapesw 




trapcsX idata 


MC68020 

MC68020 


trapeq 


trap on equal 


trapeq X 


MC68020 


trapeql 

trapeqw 




trapeqX %data 


MC68020 

MC68020 


trapf 


trap on never true 


trapfX 


MC68020 


trapf 1 
trapfw 




trapfX %data 


MC68020 

MC68020 


trapge 


trap on greater or equal 


trapgeX 


MC68020 


trapgel 

trapgew 




trapgeX %data 


MC68020 

MC68020 


trapgt 


trap on greater 


trapgtX 


MC68020 


trapgtl 

trapgt 




trapgtX %data 


MC68020 



The following table describes the MC6888 1 instruction mnemonics supported by 
as. 

Each mnemonic indicates the data type that it operates on by the last character of 
the mnemonic: 

□ b indicates a byte format instruction 

□ w indicates a word format instruction 

□ 1 indicates a long format instruction 

□ s indicates a single-precision format instmction 

□ d indicates a double-precision format instruction 
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68 Assembly Language Reference 



□ x indicates an extended-precision format instruction 

□ p indicates a packed format instruction 

□ y indicates that any of 1, s, p, w, d, or b, are acceptable. 



Table B -2 MC6888 1 Instructions supported by as 



Mnemonic 


Operation Name 


Syntax 


fabsx 


absolute value 


fabsx ea, £ n 


fabsl 




fabsx f m, f n 


fabss 




fabsy ea,fn 


fabsp 






fabsw 






fabsd 






fabsb 






facosx 


arc cosine 


facosx ea,£n 


facosl 




facosx f m, f n 


facoss 




facosy ea,£n 


facosp 






facosw 






facosd 






facosb 






faddx 


add 


faddx ea, £ n 


faddl 




faddx £m,£n 


fadds 




faddy ea, £ n 


faddp 






faddw 






faddd 






faddb 






fasinx 


arc sin 


fasinx ea,£n 


fasinl 




fasinx f m, £ n 


fasins 




fasiny ea, fn 


fasinp 






fasinw 






fasind 






fasinb 






fatanx 


arc tangent 


fatanx ea,£n 


fatanl 




fatanx f m, £ n 


fatans 




fatany ea, £ n 


fatanp 






fatanw 






fatand 






fatanb 






fatanhx 


hyperbolic arc tangent 


fatanhx ea, £ n 


fatanhl 




fatanhx f m, £ n 


fatanhs 




fatanhy ea, £ n 
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Table B-2 MC68881 Instructions supported by a s — Continued 



Mnemonic 


Operation Name 


Syntax 


fatanhp 

fatanhw 

fatanhd 

fatanhb 


hyperbolic arc tangent (contd.) 




fbcc 


branch conditionally 


fbcc label 


fbeq 

fbeql 


(equal) 




fbf 

fbfl 


(false) 




fbgt 

fbgtl 


(greater than) 




fble 

fblel 


(less than or equal) 




fblt 

fbltl 


(less than) 




fbge 

fbgel 


(greater than or equal) 




fbgl 

fbgll 


(greater than or less) 




fbgle 

fbglel 


(greater less or equal) 




fbgt 


(greater than) 




fbne 

fbnel 


(not equal) 




fbneq 

fbneql 


(not (equal)) 




fbnge 

fbngel 


(not greater than or equal) 




fbngl 

fbngll 


(not greater than or less) 




fbngle 

fbnglel 


(not greater than, less or equal) 




fbngt 

fbngtl 


(not greater than) 




fbnle 

fbnlel 


(not less than or equal) 




fbnlt 

fbnltl 


(not less than) 




fbt 

fbtl 


(true) 




fbor 

fborl 


(ordered) 




fboge 

fbogel 


(ordered greater or equal) 




fbogl 


(ordered greater or less) 
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Table B-2 MC6888 1 Instructions supported by a s — Continued 



Mnemonic 


Operation Name 


Syntax 


fbogll 






fbogt 

fbogtl 


(ordered greater than) 




fbole 

fbolel 


(ordered less or equal) 




fbolt 

fboltl 


(ordered less than) 




fbseq 

fbseql 


(signalling equal) 




fbsf 
fbsf 1 


(signalling false) 




fbsne 

fbsnel 


(signalling not equal) 




fbst 

fbstl 


(signalling true) 




fbueq 

fbueql 


(unordered equal) 




fbuge 

fbugel 


(unordered greater or equal) 




fbugt 

fbugtl 


(unordered greater than) 




fbule 

fbulel 


(unordered less or equal) 




fbult 

fbultl 


(unordered less than) 




fbun 

fbunl 


(unordered) 




f cmpx 


compare 


f cmpx ea, fn 


fcmpl 




f cmpx f m, f n 


fcmps 
f cmpp 
f cmpw 
fcnrpd 
f cmpb 




f cmpy ea, fn 


f cosx 


cosine 


fcosx ea, fn 


fcosl 




fcosx fm,fn 


fcoss 

fcosp 

fcosw 

fcosd 

fcosb 




fcosy ea,£n 


fcoshx 


hyperbolic cosine 


fcoshx ea,fn 


fcoshl 




fcoshx fm,fn 


fcoshs 




f coshy ea, fn 
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Table B-2 


MC6888 1 Instructions supported by as — Continued 




Mnemonic 


Operation Name 


Syntax 


fcoshp 


f coshw 
fcoshd 
fcoshb 


hyperbolic cosine (contd.) 




fdbcc 


decrement & branch on condition 


fdbcc d/i, label 


fdbeq 


(equal) 




fdbne 


(not equal) 




fdbgt 


(greater than) 




fdbngt 


(not greater than) 




f dbge 


(greater or equal) 




fdbnge 


(not greater or equal) 




fdblt 


(less than) 




fdbnlt 


(not less than) 




fdble 


(less or equal) 




fdbnle 


(not less or equal) 




fdbgl 


(greater or less) 




fdbngl 


(not greater or less) 




fdbgl e 


(greater, less or equal) 




fdbngle 


(not greater, less or equal) 




fdbogt 


(ordered greater than) 




fdbule 


(unordered less or equal) 




fdboge 


(unordered greater or equal) 




fdbult 


(unordered less than) 




fdbolt 


(ordered less than) 




fdbuge 


(unordered greater or equal) 




fdbole 


(ordered less or equal) 




fdbugt 


(unordered greater than) 




fdbogl 


(ordered greater or less) 




fdbueq 


(unordered equal) 




fdbor 


(ordered) 




fdbun 


(unordered) 




fdbf 


(false) 




fdbt 


(true) 




fdbsf 


(signalling false) 




fdbst 


(signalling true) 




fdbseq 


(signalling equal) 




fdbsne 


(signalling not equal) 




fdivx 


divide 


fdivx ea, f n 


fdivl 




fdivx fm, f n 


fdivs 

fdivp 

fdivw 

fdivd 

fdivb 




fdivy ea,fn 
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Table B-2 MC6888 1 Instructions supported by as — Continued 



Mnemonic 


Operation Name 


Syntax 


fetoxx 


X 

e 


fetoxx ea, f n 


fetoxl 




fetoxx fm,fn 


fetoxs 

fetoxp 

fetoxw 

fetoxd 

fetoxb 




fetoxy ea, f n 


fetoxmlx 


x i 
e -1 


fetoxmlx ea,fn 


fetoxmll 




fetoxmlx f m, f n 


fetoxmls 




fetoxmly ea,fn 


fetoxmlp 






fetoxmlw 






fetoxmld 






fetoxmlb 






fgetexpx 


get exponent 


fgetexpx ea,fn 


fgetexpl 




fgetexpx f m, f n 


fgetexps 

fgetexpp 

fgetexpw 

fgetexpd 

fgetexpb 




f getexpy ea, f n 


fgetmanx 


get mantissa 


fgetmanx ea,fn 


fgetmanl 




fgetmanx f m, f n 


fgetmans 

fgetmanp 

fgetmanw 

fgetmand 

fgetmanb 




fgetmany ea,fn 


fintx 


integer part 


fintx ea, f n 


fintl 




fintx f m, f n 


f ints 
fintp 
fintw 
fintd 
fintb 




f inty ea, f n 


f intrx 


integer part, round toward 0 


fintrx ea, f n 


f intrzl 




fintrx fm,fn 


fintrzs 
f intrzp 
f intrzw 
fintrzd 
f intrzb 




fintry ea, f n 
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Table B-2 


MC6888 1 Instructions supported by as— 


- Continued 


Mnemonic 


Operation Name 


Syntax 


f jcc 


jump on condition 


f jcc label 


f jeq 


(equal) 




f jne 


(not equal) 




f jneq 


(not equal or equal) 




f jgt 


(greater than) 




f jngt 


(not greater than) 




f jge 


(greater or equal) 




f jnge 


(not greater or equal) 




f jit 


(less than) 




f jnlt 


(not less than) 




f jle 


(less or equal) 




f jnle 


(not less or equal) 




f jgl 


(greater or less) 




f jngl 


(not greater or less) 




f jgle 


(greater, less or equal) 




f jngle 


(not greater, less or equal) 




f jogt 


(ordered greater than) 




f jule 


(unordered less or equal) 




f joge 


(ordered greater or equal) 




f jult 


(unordered less than) 




f jolt 


(ordered less than) 




f juge 


(unordered greater or equal) 




f jole 


(ordered less or equal) 




f jugt 


(unordered greater than) 




f jogl 


(ordered greater or less) 




f jueq 


(unordered equal) 




f jor 


(ordered) 




f jun 


(unordered) 




fjf 


(false) 




f jt 


(true) 




f j sf 


(signalling false) 




f jst 


(signalling true) 




f j seq 


(signalling equal) 




f j sne 


(signalling not equal) 




f loglOx 


lo *10 


floglOx ea,in 


floglOl 




floglOx im,in 


f loglOs 
floglOp 
f loglOw 
f loglOd 
floglOb 




floglOy in 


f log2x 


!°g 2 


flog2x ea,in 


f log21 




flog2x fm r fn 


f log2s 
f log2p 




f log2y ea, in 
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Table B-2 MC6888 1 Instructions supported by a s — Continued 



Mnemonic Operation Name Syntax 



flog2w 

flog2d 

flog2b 


log 2 (contd.) 




flognx 


i°g e 


flognx ea,fn 


flognl 




flognx f m, f n 


f logns 
flognp 
flognw 
flognd 
flognb 




flogn y ea,fn 


flognplx 


log e (x+l) 


flognplx ea, f n 


flognpll 




flognplx f m, fn 


flognpls 
flognplp 
flognplw 
flognpld 
flognp lb 




flognply ea,fn 


fmodx 


modulo 


fmodx ea, f n 


fmodl 




fmodx f m, fn 


fmods 

fmodp 

fmodw 

fmodd 

fmodb 




fmody ea, fn 


fmovex 


move fp register 


fmovex ea, fn 


fmovel 




fmovex fm,ea 


f moves 
fmovep 
fmovew 
fmoved 
fmoveb 




f movey ea , fn 


fmovecrx 


move constant ROM 


fmovecrx #ccc, fn 


fmovemx 


move multiple data registers 


fmovemy ea, list 


fmoveml 




fmovemx list, ea 


fmovem 




fmoveml ea, dn 
fmovem dn, ea 


fmulx 


multiply 


fmulx ea, fn 


fmull 




fmulx f m, fn 


fmuls 

fmulp 




fmuly ea,fn 



microsystems 



Revision A of May 9, 1988 














Appendix B — List of as Opcodes 75 




fnegx negate 

fnegl 

fnegs 

fnegp 

fnegw 

fnegd 

fnegb 



fnop 


no operation 


fnop 


fremx 


IEEE remainder 


fremx ea, f n 


f reml 




fremx f m, fn 


f rems 




fremy ea,fn 


f remp 






f remw 






f remd 






f remb 






f restore 


restore internal state 


frestore ea 


f save 


save internal state 


fsave ea 


f scalex 


scale exponent 


f scalex ea, fn 


f scalel 




f scalex fm,fn 


f scales 




fscaley ea, fn 


f scalep 






f scalew 






f scaled 






f scaleb 







f see 
f seq 
f sne 
f sneq 
f sgt 
f sngt 
f sge 
f snge 
f sit 
f snlt 
f sle 
f snle 
f sgl 
f sngl 
f sgle 
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set according to condition f see ea 

(equal) 

(not equal) 

(not equal or equal) 

(greater than) 

(not greater than) 

(greater or equal) 

(not greater or equal) 

(less than) 

(not less than) 

(less or equal) 

(not less or equal) 

(greater or less) 

(not greater or less) 

(greater, less or equal) 



fnegx ea, fn 
fnegx f m , f n 
fneg y ea,fn 
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Table B-2 MC6888 1 Instructions supported by as — Continued 



Mnemonic 


Operation Name 


Syntax 


f sngle 


(greater, less or equal) 




f sogt 


(not greater, less or equal) 




f sule 


(unordered less or equal) 




f soge 


(ordered greater or equal) 




fsult 


(unordered less than) 




f solt 


(ordered less than) 




f suge 


(unordered greater or equal) 




f sole 


(ordered less or equal) 




f sugt 


(unordered greater than) 




f sogl 


(ordered greater or less) 




fsueq 


(unordered equal) 




f sor 


(ordered) 




f sun 


(unordered) 




f sf 


(false) 




f st 


(true) 




f ssf 


(signalling false) 




f sst 


(signalling true) 




f sseq 


(signalling equal) 




f ssne 


(signalling not equal) 




f sgldivx 


single-precision divide 


f sgldivx ea,fn 


f sgldivs 




f sgldivx fm,fn 


f sgldivl 




fsgldivy ea,£n 


f sgldivp 






f sgldivw 






f sgldivb 






f sglmulx 


single-precision multiply 


f sglmulx ea,£n 


f sglmuls 




f sglmulx fm,fn 


f sglmull 




fsglmuly ea,fn 


f sglmulp 






f sglmulw 






f sglmulb 






f sinx 


sin 


fsinx ea,fn 


f sinl 




f sinx f m, f n 


f sins 




f siny ea, f n 


f sinp 






f sinw 






f sind 






f sinb 






f sincosx 


simultaneous sine and cosine 


f sincosx ea r fc:fs 


f sincosl 




f sincosx fm r £c:£s 


f sincoss 




fsincos y ea,£c:£s 


f sincosp 
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Table B-2 MC6888 1 Instructions supported by a s — Continued 



Mnemonic Operation Name Syntax 



f sincosw 


simultaneous sine and cosine ( contd.) 




f sincosd 






f sincosb 






f sinhx 


hyperbolic sine 


f sinhx ea, f n 


f sinhs 




f sinhx fm r fn 


f sinhp 
f sinhw 
f sinhd 
f sinhb 




f sinhy ea, f n 


f sqrtx 


square root 


f sqrtx ea, fn 


f sqrtl 




f sqrtx fm,fn 


f sqrts 
f sqrtp 
f sqrtw 
f sqrtd 
f sqrtb 




f sqrt y ea, fn 


fsubx 


subtract 


fsubx ea,fn 


f subl 




fsubx f m, fn 


f subs 
f subp 
f subw 
f subd 
f subb 




fsub y ea,fn 


ftanx 


tangent 


ftanx ea, fn 


ftanl 




ftanx f m, fn 


ftans 

ftanp 

ftanw 

ftand 

ftanb 




ftany ea, fn 


ftanhx 


hyperbolic tangent 


ftanhx ea,fn 


ftanhl 




ftanhx fm, fn 


ftanhs 




ftanhy ea, fn 


ftanhp 






ftanhw 






ftanhd 






ftanhb 






ftentoxx 


10 x 


ftentoxx ea,fn 


ftentoxl 




ftentoxx fm, fn 


ftentoxs 




ftentoxy ea,fn 


ftentoxp 
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Table B-2 MC6888 1 Instructions supported by as — Continued 



Mnemonic 



Operation Name 



Syntax 



ftentoxw 

ftentoxd 

ftentoxb 



10 x (contd.) 



trap conditionally 
(equal) 



ftrapcc 
ftrapcc idata 



(not equal) 



(greater than) 



(not greater than) 



(greater or equal) 



(not greater or equal) 



(less than) 



(not less than) 



(less than or equal) 



(not less than or equal) 



(greater than or less) 



(not greater than or less) 



(greater, less or equal) 



sun 
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Table B -2 MC6888 1 Instructions supported by a s — Continued 



Mnemonic 


Operation Name 


Syntax 


ftrapngle 

ftrapnglew 

ftrapnglel 


(not greater, less or equal) 




ftrapogt 

ftrapogtw 

ftrapogtl 


(ordered greater than) 




ftrapule 

ftrapulew 

ftrapulel 


(unordered less or equal) 




ftrapoge 

ftrapogew 

ftrapogel 


(ordered greater or equal) 




ftrapult 

ftrapultw 

ftrapultl 


(unordered less than) 




ft rapolt 
ft rapoltw 
ftrapoltl 


(ordered less than) 




ftrapuge 

ftrapugew 

ftrapugel 


(unordered greater or equal) 




ftrapole 

ftrapolew 

ftrapolel 


(ordered less or equal) 




ftrapugt 

ftrapugtw 

ftrapugtl 


(unordered greater than) 




ftrapogl 

ftrapoglw 

ftrapogll 


(ordered greater or less) 




ftrapueg 

ftrapueqw 

ftrapueql 


(unordered equal) 




ftrapor 

fftraporw 

ftraporl 


(ordered) 




trapun 

ftrapunw 

ftrapunl 


(unordered) 




ftrapf 
ft rapfw 
ftrapf 1 


(false) 




ft rapt 
ftraptw 
ft raptl 


(true) 
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Mnemonic 



Table B-2 MC6888 1 Instructions supported by a s — Continued 



Operation Name 



Syntax 



ft raps f 
ft rapt w 
ftrapsf 1 
ft rapst 
ft raps fw 
ftrapstl 
ft raps eq 
ftrapseqw 
ftrapseql 
ftrapsne 
ftrapsnew 
ftrapsnel 



ftstx 
ftstl 
ft sts 
ft stp 
ftstw 
ftstd 
ft stb 



(signalling false) 



(signalling true) 



(signalling equal) 



(signalling not equal) 



test operand 



ftstx ea 
ftstx f m 
ft sty ea 



ftwotoxx 

ftwotoxl 

ftwotoxs 

ftwotoxp 

ftwotoxw 

ftwotoxd 

ftwotoxb 



ftwotoxx ea, f n 
ftwotoxx fffl, fn 
ftwotoxy ea,fn 
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FPA Assembler Syntax 



This appendix describes the Sun Floating-Point Accelerator (FPA) support exten- 
sions toas included in Sun software release 3.1 and later. 

The extensions to as are described in general, with discussions of two-, three-, 
and four-operand instruction examples. Some instructions covered separately 
don’t follow the formats described at the beginning of the appendix. The appen- 
dix includes restrictions and potential errors, followed by a summary of sup- 
ported floating-point instructions. 

C.l. Instruction Syntax The general format for floating-point instructions is 




where 



f p indicates an FPA instruction. 
op is the opcode name. 

t is the operand type, either single (s) or double (d). 

The @A part of the instruction is optional. When present, A specifies the address 
register which contains the base address for the FPA and can be in the range 0..7. 
If this form is used, a previous instruction must load the FPA address 
(OxeOOOOOOO) into the specified address register. 

If 0A is not present, then absolute long addressing is used to refer to the FPA. 
This form is more efficient for short routines. 

Depending on the instruction, there may be from zero to four operands specified. 
The operands can be any of the following forms: 

□ Any MC68020 effective address, with the exception that absolute short 
addresses are not allowed for double-precision values. 



□ If either of the data register or the address register is used to hold a double- 
precision value, then the value will be in a register pair and both registers, 
separated by a colon, must be specified in the instruction. For example: 
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The only exception to this rule is the fpltod instruction (convert integer to 
double-precision value). 

□ In some instructions (command register type) it is possible to specify that the 
register be in constant RAM. The syntax used for this case is %n, where n is 
a register number in the range 0 to 51 1. 

C.2. Register Syntax The 32 floating-point data registers are designated fpaO, fpal, 

fpa31. The supported control registers are: 



Hardware 


Software 


MODE3_0 


fpamode 


WSTATUS 


fpastatus 



C.3. Operand Types 



C.4. Two-Operand 
Instructions 



as supports three floating-point operand types: 

□ s for single-precision floating-point operands. 

□ d for double-precision floating-point operands. 

□ 1 for 32-bit integer operands, used for integer to floating-point conversions. 



Opcodes such as add, subtract, multiply, divide, negate, absolute value, square 
root, conversion from integer to floating-point, conversion from single to double 
(and vice versa) are all represented as: 



f 


s 


fpopt X, fpa n 




V 


J 



where t= s or d, and X is any valid MC68020 effective address for an operand or 
is an FPA data register. 

If X is an FPA register which is in the constant RAM, then it can be in the range 
0 to 5 1 1 . If it is not in constant RAM, then it is one of the 32 FPA data registers. 
When X is an FPA register, then f pan is one of the 32 floating-point data regis- 
ters. If X is an effective address, then f pan is one of the FPA registers in the 
range 0 to 15. The following are examples of such instructions: 



— 




\ 




Instruction 


Computes 


fpnegs 


<effective address> , fpa 1 




fpsqrd 


<effective address> , fpa 2 




fpsubs 


fpal, fpa2 


fpa2 <- fpa2 - fpal 


fprsubs 


fpal, fpa2 


fpa2 <r- fpal - fpa2 


fpdivs 


dO, fpa2 


fpa2 <r- fpa2 / dO 


fprdivs 


dO, fpa2 


fpa2 <- dO / fpa2 






J 



In the above examples fpr subs and fprdivs are the reverse subtract and 
reverse divide operators, respectively. 




microsystems 
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The opcodes for sine, cosine, atan, e~x, e~x -1, In (x) , 
ln(l+x), sqrt(x),and sincos (x) are all supported as command register 
type instructions: 



r 


-\ 


fpo/rt fpax, fpan 




V 


y 



where t= s or d. 

f pax is either a floating-point register or a register in the constant RAM (which 
is specified as % number). For the sincos instruction, the destination operand 
is actually a register pair: 




C.5. Three-Operand 
Instructions 



where f pac is the cosine’s destination and f pas is the sine’s destination. 



The opcodes +, -, *, / are supported in extended and command register forms as 



f 




\ 


fpop3t 


X , fpa m, fpa n 




V 




j 



where t = s or d and X is an <ejfective address> for an extended instruction or 
a floating-point register for a command register type of instruction. 

In the command register form, X and fpam can indicate a register number in the 
constant RAM. That is, they can either be in the range 0 to 51 1 or in the range 0 
to 31. In the extended instruction form, fpa m and fpa n must be in the range 
0 to 15. In the above format the positions of X and f pam can be exchanged for 
the commutative operators add and multiply (the result of the operation remains 
the same). 



For example. 



s 

fpa2 <- <ejfective address> + fpal 




v 


J 



can be represented by either of the following forms: 

^ 

fpadd3s <effective address> , fpal, fpa2 

fpadd3s fpal, <ej fective address> , fpa2 

s 



The same rule applies to subtract and divide operations. However, they are not 
commutative, so different answers result from each order. For example, 



fpa2 <r- fpal - <ej ffective address> 




v 


J 



must be coded as: 



f 




N 




fpsub3s <effective address> , fpal, fpa2 








2 
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whereas 




must be coded as: 




Following the same format. 




must be coded as: 




C.6. Four-Operand In the extended and command register formats there are pivot instructions of the 

Instructions form: 




where f pan is the destination floating-point data register, t- s or d, and X is 
an effective address or a floating-point register. 

In the extended form, the positions of X and f pay can be exchanged for both 
single- and double-precision types of instructions. In single-precision extended 
form, it is possible for two of the four operands to be effective addresses. This is 
in general either the first and third or the second and third operands. 

In the command register form, f pa* and f pay can be replaced by %x and %y 
indicating register numbers x and y in the constant RAM. 

For four-operand instructions, f pax, f pay and f pan can each be in the range 
0 to 15 when X is an effective address. If X is an FPA register, then X and f pan 
must be in the range 0 to 31 and fpax and fpay can either be in the range 0 to 
511 (designating a location in constant RAM) or else in the range 0 to 31. 

These pivot instructions are rather complicated and will be dealt with com- 
pletely. The following shows the forms of each operation, the assembly code 
equivalent to each form, a generalization of the assembly instruction and a 
sequence of operations equivalent to the pivot instruction. 
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r 


Instruction 




Meaning 




f pma { s , d } 


<ej ffective address> , reg2, reg3 , 


regl 


regl <— reg3 + (reg2 * operand) 




fpma { s, d} 


reg2 , reg3 , <effective address> , 


regl 


regl <r- operand + (reg3 * reg2) 




f pma { s , d } 


reg4, reg2, reg3, regl 




regl <— reg3 + (reg2 * reg4) 




fpmas 


<eal> , reg2, <ea2>, regl 


regl <— operand2 + (reg2 * operandl) 


/ 



The f pma instruction, where m stands for multiply, and a stands for add, can 
be generalized as 



r 


A 


fpmaf X, fpax, fpay, fpan 




V 


J 



where t is s or d, and X is an <effective address or one of the floating-point 
data registers. In the extended type of instruction, the positions of X and f pay 
can be exchanged. Also, for single precision either the first and third operands or 
the second and third operands can be effective addresses. Note that, for example, 



fpmas dO, fpal, fpa2, fpa3 


■N 


v 


J 



is equivalent to the following sequence of instructions 



/ 






fpmul3s 


dO, fpal f temp 




fpadd3s 


temp, fpa2, temp 




fpmoves 


temp, fpa3 




v 




J 



where temp is a temporary register. 



Instruction 



Meaning 



fpms { s , d} 
fpms { s, d} 
fpms { s, d} 
fpmss 



<effective address>, reg2 , reg3, regl regl <— reg3 - (reg2 * operand) 

reg2 , reg3 , <effective address>, regl regl <— operand - (reg3 * reg2) 

reg4, reg2, reg3, regl regl <— reg3 - (reg2 * reg4) 

<eal>, reg2, <ea2 > , regl regl <— operand2 - (reg2 * operand 1) 



The fpms instruction, where m stands for multiply, and s stands for subtract, 
can be generalized as 



— 




A 


fpms/ 


X, fpar, fpay, fpan 




V 




J 



where t is s or d, and X is an <effective address> or one of the floating-point 
data registers. In the extended type of instruction, the positions of X and f pay 
can be exchanged. Also, in single-precision two-memory instructions, either the 
first and third operands or the second and third operands can be effective 
addresses. Note that, for example. 



/ 

fpmss fpal, fpa2, dO, fpa3 


A 


v 


J 
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is equivalent to the following sequence of instructions 



f 






\ 


fpmul3s 


fpal, 


fpa2, temp 




fpsub3s 


temp. 


dO, temp 




fpmoves 


temp. 


fpa3 


j 



The f pmr instruction, where m stands for multiply, and r stands for reverse 
subtract, can be generalized as 



f 




— 


fpmr/ 


X, fpajc, fpay, fpan 








J 



where t is s or d, and X is an <effective address> or one of the floating-point 
data registers. In the extended type of instruction, the positions of X and f pay 
can be exchanged. 



Instruction 



Meaning 



fpmr {s, d} 
fpmr {s,d} 
fpmr { s , d } 
fpmrs 



<effective address>, reg2 , reg3, regl regl <— (-reg3) + (reg2 * operand) 

reg2 , reg3 , <effective address>, regl regl <— (-operand) + (reg3 * reg2) 

reg4, reg2 , reg3, regl regl <— (-reg3) + (reg2 * reg4) 

<eal>, reg2, <ea2>, regl regl <— (-operand2) + (reg2 * operand 1) 



In single-precision extended form either the first and third operands or the second 
and third operands can be effective addresses. Note that, for example, 



r 

fpmrs dO, fpal, fpa2, fpa3 


j 


is equivalent to the following sequence of instructions: 




fpmul3s dO, fpal, temp 

fpsub3s fpa2, temp, temp 

fpmoves temp, fpa3 






J 


The fpam instruction, where a stands for add, and m 
be generalized as 


stands for multiply, can 


( 

fpam/ X, f pajc, fpay, fpa/i 




V 


J 



where t is s or d, and X is an <ejfective address or one of the floating-point 
data registers. In the extended type of instruction, the positions of X and f pay 
can be exchanged. 
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r 


Instruction 


Meaning 




fpam{ s, d} 


<effective address> , regl, regl, regl 


regl <- reg3 * (reg2 + operand) 




fpam{ s, d} 


reg2, reg3, <effective address> , regl 


regl <— operand * (reg3 + reg2) 




fpam{ s, d} 


reg4, reg2, reg3, regl 


regl <— reg3 * (reg2 + reg4) 




fpams 

V. 


<eal>, reg2, <ea2>, regl regl <— operand2 * (reg2 + operand 1) 


> 



In single-precision two-memory instructions, either the first and third operands or 
the second and third operands can be effective addresses. Note that, for example, 



f 

fpams fpal, fpa2, fpa3, fpa4 


j 


is equivalent to the following sequence of instructions: 




f 

fpadd3s fpal, fpa2, temp 
fpmul3s temp, fpa3, temp 
fpmoves temp, fpa4 


A 




J 


The f psm instruction, where s stands for subtract, and 
can be generalized as 


m stands for multiply, 


f 

fpsm/ X, fpax, fpay, fpan 




L 


y 



where t is s or d, and X is an effective address or one of the floating-point data 
registers. In the extended type of instruction, the positions of X and f pay can 
be exchanged. The special cases for single-precision instructions are that either 
the first and third operands or the second and third operands can be effective 
addresses. 



Instruction 



Meaning 



fpsm{ s, d} 
fpsm{ s, d) 
fpsm{ s, d} 
fpsm{ s, d} 
fpsm{ s, d} 
fpsms 
fpsms 



<effective address> , reg2 , reg3 , 
reg2, reg3, <effective address > , 
reg4, reg2, reg3, regl 
r eg2 , <effective address > , reg3 , 
reg2, reg4, reg3, regl 
<eal>, reg2, <ea2>, regl 
reg2, <eal> , <ea2 > , regl 



regl regl <— reg3 * (reg2 - operand) 

regl regl <- operand * (reg3 - reg2) 

regl <- reg3 * (reg2 - reg4) 
regl regl <- reg3 * (-reg2 + operand) 

regl <r- reg3 * (-reg2 + reg4) 
regl <r- operand2 * (reg2 - operand 1) 

regl <- operand2 * (-reg2 + operand 1) 



Note that, for example, 



r 

fpsms dO, fpal, fpa2, fpa3 


— 


L 


> 



is equivalent to the following sequence of instructions: 
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fpsub3s dO, fpal, temp 
fpmul3s temp, fpa2, temp 
fpmoves temp, fpa3 



C.7. Other Instructions 



Other special instructions are listed below. In each of them the last operand is 
also the destination, except for tst, cmp and mcmp where fpastatus is 
the implied destination. X is either an effective address or an FPA data register 
and t is either s or d for all instructions except fpmovei, where t can be s, 
d, or 1. 



Table C-l Other Instructions 



Mnemonic 



Operand 



Operation Name 



fptstf 



fpcmpf 

fpmcmpr 



fpmovef 
fpmove 2 f 
fpmove 3f 
fpmove 4/ 



fpdot2f 

fpdot3/ 



fpdot4f 



fptran2f 

fptran3f 

fptran4f 



fpmove 

fpmove 

fpmove 

fpmove 

fpmovef 

fpmovef 




X, fpa m 
X, fpam 



fpa m, fpa n 
fpa m, fpan 
fpam, fpan 
fpam, fpan 



fpax, fpay, fpan 
f par, fpay, fpan 



f pax, fpay, fpan 



fpam, fpan 
fpam, fpan 
fpam, fpan 



fpamode, <ea> 
<ea>, fpamode 
fpastatus, <ea> 
<ea>, fpastatus 
fpam, <ea> 

<ea>, fpan 



operand compare with zero 



register m compare with operand 

register m compare magnitude with operand 



move floating-point registers 
2x2 matrix move 
3x3 matrix move 
4x4 matrix move 



fpan <— f pax*fpay + 

(fpax+7) * (fpay+i) 
fpan <— f pax*fpay + 

(fpax+i) * (fpay+i) + 

(fpax+2) * (fpay+2) 
fpan <— f pax* fpay + 

(fpax+i)*(fpay+i) + (fpax+2)*(fpay+2) + 
(fpax+3)*(fpay+3) 



transpose 2x2 matrix 
transpose 3x3 matrix 
transpose 4x4 matrix 



read mode register 

write to mode register 

read status register 

write to status register 

read a floating-point data register 

write to a floating-point data register 
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C.8. Restrictions and In double-precision instructions, when absolute short addressing or a single data 

Errors or address register is used, as reports an invalid operand error. 

For the dot product and matrix move and transpose instructions, when the regis- 
ter specified does not fall within the specified range, as reports a register out of 
range error. 

For most instructions where one operand is an effective address, the register 
range is 0 to 15. If all operands are FPA registers, then the register range is 0 to 
3 1 . For constant RAM registers, the range is 0 to 5 1 1 . as reports an invalid 
operand error when any of these registers are not within the permitted range. 

In the following table, X is any valid MC68020 effective address (the form 
( xxx ) : w is not allowed for double) or FPA register. In some three- or four- 
address instructions the position of the X and one of the FPA register can be 
exchanged. This is shown in the fourth column of the following table. 



Table C-2 Floating-Point Instructions 



Instruction 


Operand 


Operation 


Alternative 


fpnegs 


X , fpa n 


negate single 




fpnegd 


X, fpan 


negate double 




fpabss 


X, fpan 


absolute value single 




fpabsd 


X, fpan 


absolute value double 




fpltos 


X, fpan 


convert integer to single 




fpltod 


X, fpan 


convert integer to double 




fpstol 


X, fpan 


convert single to integer 




fpdtol 


X, fpan 


convert double to integer 




fpstod 


X, fpan 


convert single to double 




fpdtos 


X, fpan 


convert double to single 




fpsqrs 


X, fpan 


square single 




fpsqrd 


X, fpan 


square double 




fpadds 


X, fpan 


add single 




fpadd3s 


X, fpam, fpan 


add single 


fpam, X, fpa n 


fpaddd 


X, fpan 


add double 




fpadd3d 


X, fpa m, fpan 


add double 


fpam, X, fpan 


fpsubs 


X, fpan 


subtract single 




fpsub3s 


X, fpam, fpan 


subtract single 


fpam, X, fpan 


fprsubs 


<ea>, fpan 


reverse subtract single 




fpsubd 


X, fpan 


subtract double 




fpsub3d 


X, fpa m, fpan 


subtract double 


fpam, X, fpan 


fprsubd 


<ea>, fpan 


reverse subtract double 




fpmuls 


X, fpan 


multiply single 




fpmu!3s 


X, fpam, fpan 


multiply single 


fpam, X, fpan 



C.9. Instruction Set 
Summary 
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Table C-2 Floating-Point Instructions — Continued 



Instruction 


Operand 


Operation 


Alternative 


fpmuld 


X, fpan 


multiply double 




fpmul3d 


X, fpa m, fpan 


multiply double 


fpa m, X, fpan 


fpdivs 


X, fpan 


divide single 




fpdiv3s 


X, fpa m, fpan 


divide single 


fpam, X, fpan 


fprdivs 


<ea>, fpan 


reverse divide single 




fpdivd 


X, fpan 


divide double 




fpdiv3d 


X, fpa m, fpan 


divide double 


fpa m, X, fpan 


fprdivd 


<ea>, fpan 


reverse divide double 





fpt sts 
fpt std 



fpcmps 

fpcinpd 

fpmcmps 

fpmcmpd 



f psins 
fpsind 
fpcoss 
fpcosd 
f patans 
f patand 



fpetoxs 

fpetoxd 

fpetoxmls 

fpetoxmld 



fplogns 

fplognd 

fplognpls 

fplognpld 



fpsincoss 

fpsincosd 



fpmas 



fpmad 




X, fpa m 
X, fpa m 
X, fpa m 
X, fpa m 



fpax, fpan 
fpajc, fpan 
fpax, fpan 
fpax, fpan 
fpax, fpan 
fpax, fpan 



fpax, fpan 
fpax, fpan 
fpax, fpan 
fpax, fpan 



fpax, fpan 
fpax, fpan 
fpax, fpan 
fpax, fpan 



fpax, fpac :f pas 
fpax, fpac :f pas 



single compare with 0 
double compare with 0 



single compare 
double compare 
single magnitude compare 
double magnitude compare 



sine single 
sine double 
cosine single 
cosine double 
a tan single 
atan double 



e'x single 
e'x double 
e'x-1 single 
e'x-1 double 



ln(x) single 
ln(x) double 
ln(l+x) single 
ln(l+x) double 



fpac <— cosine(x), f pas <— sine(x) 
fpac cosine(x), f pas <— sine(x) 



fpmss 



X, fpax, fpay, fpan fpan <— (fpax * X) + fpay 

X, fpax, fpay, fpan fpan <— (fpax * X) + fpay 

X, fpax, fpay, fpan fpan <— fpay - (fpax * x) 



fpax, X, fpa y, fpan 

fpay, fpax, X, fpan 
X, fpax, X, fpan 
fpax, X, X, fpan 

fpax, X, fpay, fpan 

fpay, fpax, X, fpan 

fpax, X, fpay, fpan 

fpay, fpax, X, fpan 
X, fpax, X, fpan 
fpax, X, X, fpan 
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Table C-2 Floating-Point Instructions — Continued 



Instruction 


Operand 


Operation 


Alternative 


fpmsd 


X, fpax, fpay, fpan 


fpan<— fpay - (fpax * x) 


fpax:, X, fpay, fpan 
fpay, fpax, X, fpan 


fpmrs 


X, fpax, fpay, fpan 


fpan <— (fpax * x) - fpay 


fpax, X, fpay, fpan 

fpay, fpax, X, fpan 
X, fpax, X, fpan 
fpax, X, X, fpan 


fpmrd 


X, fpax, fpay, fpan 


fpan <— (fpax * x) - fpay 


fpax, X, fpay, fpan 

fpay, fpax, X, fpa n 


fpams 


X, fpax, fpay, fpan 


fpan <— (fpax + x) * fpay 


fpax, X, fpay, fpan 

fpay, fpax, X, fpan 
X, fpax, X, fpan 
fpax, X, X, fpan 


fpamd 


X, fpax, fpay, fpan 


fpan <— (fpax + x) * fpay 


fpax, X, fpay, fpan 

fpay, fpax, X, fpan 


fpsms 


X, fpax, fpay, fpan 


fpan <— (fpax - x) * fpay 


fpax, X, fpay, fpan 

fpay, fpax, X, fpan 
X, fpax, X, fpan 
fpax, X, X, fpan 


fpsmd 


X, fpax, fpay, fpan 


fpan <— (fpax - x) * fpay 


fpax, X, fpay, fpan 

fpay, fpax, X, fpan 


fpmoves 


<ea> , fpan 


write to a register, single 




fpmoved 


<ea>, fpan 


write to a register, double 




fpmovel 


<ea> , fpan 


write to a register, integer 




fpmoves 


fpam, <ea> 


read a register, single 




fpmoved 


fpa m, <ea> 


read a register, double 




f pmove2 s 


fpam, fpan 


2x2 matrix move, single 




fpmove2d 


fpam, fpan 


2x2 matrix move, double 




f pmove3 s 


fpam, fpan 


3x3 matrix move, single 




fpmove3d 


fpam, fpan 


3x3 matrix move, double 




fpmove4s 


fpam, fpan 


4x4 matrix move, single 




fpmove4d 


fpam, fpan 


4x4 matrix move, double 




fpdot2s 


fpax, fpay, fpan 


fpan <— fpax* fpay + (fpax+i) * (fpay+i) 




fpdot2d 


fpax, fpay, fpan 


fpan <— fpax* fpay + (fpa x+i) * (fpay+i) 




fpdot3s 


fpax, fpay, fpan 


fpan <— fpax* fpay + (fpax+i) * (fpay+i) + 
(fpax+2) * (fpay+2) 




fpdot3d 


fpax, fpay, fpan 


fpan +- fpax* fpay + (fpax+i) * (fpay+i) + 
(fpax+2) * (fpay+2) 








bUU 

micros yslems 
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T able C-2 Floating-Point Instructions — Continued 



Instruction 


Operand 


Operation 


Alternative 


fpdot4s 


fpax, fpay, fpan 


fpan <— f pax* fpay + (fpax+i) * (fpay+i) + 
(fpax+2)*(fpay+2) + (fpax+J)*(fpay+3) 




fpdot4d 


fpax, fpay, fpan 


fyan<— f pax* fpay + (fpax+7) * (fpay+7) + 
(fpax+2)*(fpay+2) + (fpax+J)*(fpay+3) 




fptran2s 


fpam, fpan 


transpose 2x2 matrix, single 




fptran2d 


fpam, fpan 


transpose 2x2 matrix, double 




fptran3s 


fpam, fpan 


transpose 3x3 matrix, single 




fptran3d 


fpam, fpan 


transpose 3x3 matrix, double 




fptran4s 


fpam, fpan 


transpose 4x4 matrix, single 




fptran4d 


fpam, fpan 


transpose 4x4 matrix, double 




fpmove 


fpamode, <ea> 


read the mode register 




fpmove 


<ea>, fpamode 


write on mode register 




fpmove 


fpastatus, <ea> 


read the status register 




fpmove 


<ea>, fpastatus 


write to status register 


— 
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. comm directive, 36 
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-d2 option, 4 
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relocatable, 18 thru 19 
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FPA Assembler Syntax, 83 thru 90 

G 

. globl directive, 36 

H 

-h option, 4 

hexadecimal constants, 1 1 

I 

identifiers, 9 thru 10 
Instruction Syntax, 83 
Instructions, Two-Operand, 84 

J 

- j option, 4 
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-k option, 3 

L 

-L option, 3 
label field, 23 thru 24 
labels, 10 thru 11 
local, 10 
numeric, 10 
scope, 10 

. lcomm directive, 35 
lexical elements, 9 thru 13 
lines, 23 
local labels, 10 
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.long directive, 33 

M 

-m6 8 0 1 0 option, 3 
-m.68020 option, 3 

N 

notation, 4 thru 5 
numeric constants, 1 1 
numeric labels, 10 

o 

-o option, 3 
octal constants, 1 1 
operand field, 25 thru 26 
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operation code field, 24 thru 25 
options, 3 thru 4 
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-d2, 4 
-h, 4 
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. data, 34 
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.skip directive, 35 
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cc, 42 
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f piar, 42 
fpsr, 42 
pc, 42 
sfc, 42 
sp, 42 
sr, 42 
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comment field, 26 
direct assignment 26 thru 27 
label field, 23 thru 24 
operand field, 25 thru 26 
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. text directive, 34 
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-96 





Index — Continued 



u 

Usage Errors, 51 

w 

. word directive, 33 



- 97 - 





Notes 




Notes 




Notes 



Notes 




Notes 



